canvas-lms-mcp-local

提示

想在手机、网页或多台电脑上使用？ 请前往 🌐 远程版 →。它包含相同的 209 个工具，通过受密码保护的 ngrok 隧道提供服务，并在多台电脑之间自动故障切换。

🤔 本地版还是远程版？

✨ 亮点

• 📊 成绩分析：what_if_grade、compute_needed_score、grade_impact_ranking、完整的加权成绩明细
• 📅 规划：get_week_ahead、semester_snapshot、study_priority_ranking，一次调用即可查看所有课程的未完成作业
• 📝 提交作业：提交文本、URL 和文件，并可先预览模拟提交结果
• 💬 讨论区和收件箱：一次请求即可阅读完整讨论串，并给教师发送消息
• 📁 内容：文件、页面、模块、讲座字幕以及完整的 .imscc 课程导出

🧭 工作原理

 Your AI app (MCP client)      ──stdio──►  node index.js  ──HTTPS──►  your school's Canvas API
        (starts the server)              (209 tools, runs only
                                          while your app is open)

无需 Web 服务器，无需开放端口，也无需保持服务运行。AI 应用打开时会启动服务，关闭时会停止服务。

🚀 快速开始

你需要： Node.js 18+ 和一个 Canvas 账号。无需自行下载任何内容：AI 应用会通过 npx 获取服务。

1. 创建 Canvas 访问令牌

在 Canvas 中，前往 Account → Settings → Approved Integrations → + New Access Token。Canvas 只会显示一次令牌，请立即复制。学生令牌通常会在 30–120 天后过期。

2. 将其添加到你的 AI 应用

npx -y canvas-lms-mcp-local

3. 试用

向助手询问：“运行 test_connection。” 它会检查你的身份、课程、计划表、收件箱和未提交的作业，并报告学校禁用的功能。

然后试试这些问题：“这周有哪些截止事项？”、“期末考试需要考多少分才能拿到 B？” 或 “哪些未提交的作业对我的成绩影响最大？”

git clone https://github.com/Fireiscoolsolo/canvas-lms-mcp-local.git
cd canvas-lms-mcp-local
npm install

{ "mcpServers": { "canvas": { "command": "node", "args": ["C:/Users/YOUR-NAME/Documents/canvas-lms-mcp-local/index.js"] } } }

⚙️ 配置

按照第 2 步的示例，将设置放在配置的 env 块中。如果从源代码运行，也可以使用 index.js 同目录下的 .env 文件。

🧰 工具

🔐 安全

• **不会暴露任何内容：**服务不会监听任何端口。只有启动它的应用能通过专用管道与它通信。
• **确认门控：**发送、提交、发布或删除内容的工具会先返回预览，只有在调用时传入 confirm: true 才会执行操作。
• **提示注入隔离：**其他人编写的文本会用 <<<CANVAS_CONTENT>>> 标记括起来，并标注为不可信内容。
• **不参与测验：**不会提供测验作答端点。

切勿提交 .env。它已列入 .gitignore。请参阅 SECURITY.md。

🎓 负责任地使用

这是一款用于学习和组织事务的工具，可帮助你查看截止日期、了解成绩并规划每周安排。它不会代你参加测验；在你查看预览并确认之前，不会发送或提交任何内容。

• 请遵守学校的学术诚信和可接受使用政策。有些学校会限制使用个人 API 令牌或第三方工具。
• 想要完全避免意外更改？将 CANVAS_ALLOW_WRITES=false 设为只读模式。

🛠️ 故障排除

已知限制： 学生令牌无法访问管理端点、成绩册历史记录、课程分析或测验统计信息。smart_search 是 Canvas 的测试版功能，且经常返回 404。

📄 许可证

MIT。本项目与 Instructure 无关。