Canvas学术助理🎓
一个基于人工智能的学术管理工具，将您的Canvas LMS与Claude Desktop连接起来。通过对话式人工智能，向克劳德自然地提问有关你的课程、作业、成绩和截止日期的问题。
🌟 这有什么作用
此工具通过将Claude直接连接到您的Canvas帐户，将其转换为您的个人学术助理。与其登录Canvas并点击多个页面，你可以简单地问Claude：
- “本周我有什么作业要交？”
- “显示我目前在所有课程中的成绩”
- “我错过了什么公告？”
- “我的Canvas日历上明天有什么？”
- “帮助我确定即将到来的截止日期的优先级”
✨ 特性
📚 课程管理
- 查看所有活动课程
- 获取课程详细信息和报名信息
📝 任务跟踪
- 查看即将到来的作业和截止日期
- 获取详细的任务信息
- 检查你的待办事项清单
📊 等级监控
- 查看所有课程的成绩
- 检查作业提交状态
- 追踪你的学业进展
📅 日历集成
- 访问您的Canvas日历事件
- 查看即将到来的截止日期和截止日期
📢 保持更新
- 获取课程公告
- 查看最近的Canvas活动
- 永远不要错过重要更新
🚀 快速入门指南
先决条件
您需要：
- Canvas帐户（这是为卡内基梅隆大学创建的，但适用于任何Canvas实例）
- Claude Desktop已安装在您的计算机上
- Python 3.10或更新版本
步骤1：获取您的Canvas API代币
- 登录Canvas 在你们学校的Canvas网站上
- 点击“账户” 在左侧边栏中
- 转到“设置”
- 向下滚动到“已批准的集成”
- 点击“+新访问令牌”
- 输入目的 比如“克劳德学术助理”
- 复制生成的令牌 （你不会再看到它了！）
第二步：下载并设置
- 下载此项目 到您的计算机
- 打开终端 （Mac）或 命令提示符 （Windows）
- 导航到项目文件夹：
cd path/to/canvas-mcp-server步骤3：安装依赖项
- 创建虚拟环境：
python3 -m venv venv- 激活它：
- Mac/Linux： source venv/bin/activate - 窗户： venv\Scripts\activate
- 安装所需的软件包：
pip install mcp httpx python-dotenv pydantic步骤4：配置您的令牌
- 打开
.env文件 在项目文件夹中 - 替换令牌 与你的：
CANVAS_API_TOKEN=your_token_here
CANVAS_BASE_URL=https://your-school.instructure.com步骤5：测试设置
运行此命令以确保一切正常：
python src/canvas_server.py您应该看到：
✅ Canvas API connection successful
🚀 Canvas MCP Server started按 Ctrl+C 停止测试。
步骤6：连接到克劳德桌面
- 查找您的Claude Desktop配置文件：
- 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%/Claude/claude_desktop_config.json
- 添加此配置 （将路径替换为您的实际项目位置）：
{
"mcpServers": {
"Canvas Academic Assistant": {
"command": "/path/to/your/canvas-mcp-server/venv/bin/python",
"args": [
"/path/to/your/canvas-mcp-server/src/canvas_server.py"
],
"env": {
"CANVAS_API_TOKEN": "your_token_here"
},
"enabled": true,
"autostart": true
}
}
}- 重新启动克劳德桌面 完全（退出并重新打开）
🎯 如何使用
一旦设置好，你可以问克劳德关于你学术生活的自然问题：
📋 分配管理
- “本周有什么作业要交？”
- “显示我数学作业的详细信息”
- “我需要担心的下一个截止日期是什么？”
- “帮助我优先处理即将到来的任务”
📊 成绩跟踪
- “我目前的成绩是多少？”
- “我在计算机科学方面做得怎么样？”
- “显示我上次作业的成绩”
📅 进度计划
- “明天我的日历上有什么？”
- “我下一次考试是什么时候？”
- “本周我有什么Canvas活动？”
📢 保持更新
- “我的课程有什么新消息吗？”
- “我错过了什么Canvas活动？”
- “显示教授的最新更新”
🤖 AI驱动的帮助
- “帮助我根据截止日期制定学习计划”
- “我今天应该关注什么？”
- “提醒我即将到来的重要日期”
🔧 故障排除
❌ “无法连接到MCP服务器”
- 确保配置中的Python路径正确
- 检查您的虚拟环境是否设置正确
- 验证您的Canvas令牌是否仍然有效
❌ “Canvas API连接失败”
- 在中仔细检查您的Canvas令牌
.env文件 - 确保画布URL正确
- 验证您是否已连接到互联网
❌ “未返回数据”
- 确保你参加了现行课程
- 检查您的Canvas帐户是否具有适当的权限
- 尝试重新生成Canvas API令牌
🆘 需要帮助？
- 检查配置中的所有文件路径是否都是绝对路径
- 确保您的Canvas令牌尚未过期
- 更改任何配置后重新启动Claude Desktop
- 首先使用上述步骤5手动测试服务器
🎓 专为学生打造
这个工具最初是为卡内基梅隆大学的学生创建的，但适用于任何Canvas装置。它旨在帮助学生：
- 节省时间 通过对话获取信息，而不是点击Canvas
- 保持井然有序 采用人工智能的截止日期管理
- 从未错过 重要公告或截止日期
- 专注于学习 而不是行政任务
🔒 隐私和安全
- 您的Canvas令牌保留在您的计算机上，不会向外部服务器发送任何内容
- 所有通信都在Claude Desktop和Canvas实例之间本地进行
- 您的学术数据保持私密和安全
📚 您可以访问的内容
该工具提供对您在Canvas中看到的相同信息的访问：
- 您注册的课程
- 任务详情和截止日期
- 你的成绩和提交
- 课程公告
- 日历事件
- 最近的活动
注： 您只能访问自己的数据，权限与直接使用Canvas时相同。
______________________________________________________________________
准备好改变你的学术工作流程了吗？在10分钟内完成设置，并开始与克劳德就你的课程进行对话！ 🚀