canvas-parent-mcp

Canvas LMS（Instructure）的 MCP 服务 — 支持读取课程、成绩、作业、公告、日程规划项（planner items）和会话（conversations），以及下载课程文件。其功能范围与兄弟项目 infinitecampus-mcp 中的家长/观察者（parent/observer）视角保持一致。

• npm： npmjs.com/package/canvas-parent-mcp
• 源码： github.com/chrischall/canvas-parent-mcp

安装配置

选项 A — 使用 npx（推荐）

将以下内容添加至项目根目录下的 .mcp.json 文件，或用户主目录下的 ~/.claude/mcp.json：

{
  "mcpServers": {
    "canvas": {
      "command": "npx",
      "args": ["-y", "canvas-parent-mcp"],
      "env": {
        "CANVAS_BASE_URL": "https://cms.instructure.com"
      }
    }
  }
}

在已安装 fetchproxy 浏览器扩展且当前浏览器标签页中已登录 Canvas 的前提下，上述配置即已足够 —— MCP 启动时会自动读取您的会话 Cookie。如需改用其他认证方式，可在 env 区块中额外添加 CANVAS_TOKEN、CANVAS_CLIENT_*/CANVAS_REFRESH_TOKEN，或 CANVAS_USERNAME/CANVAS_PASSWORD。

选项 B — 从源码构建

git clone https://github.com/chrischall/canvas-parent-mcp
cd canvas-parent-mcp
npm install && npm run build

认证方式

fetchproxy 回退方案（推荐，零配置）。仅需设置 CANVAS_BASE_URL。安装 fetchproxy 浏览器扩展，并在浏览器中完成一次 Canvas 实例登录。MCP 启动时将从当前标签页中读取 canvas_session 和 pseudonym_credentials Cookie；此后所有 API 请求均由 Node.js 直接发起。该方式兼容任意认证流程（包括 SSO、SAML 和 2FA）。

替代认证方式（通过环境变量）

• 个人访问令牌（Personal access token） — 设置 CANVAS_TOKEN。大多数机构已对非管理员用户禁用此方式。
• OAuth — 设置 CANVAS_CLIENT_ID、CANVAS_CLIENT_SECRET 和 CANVAS_REFRESH_TOKEN。可通过 canvas-parent-mcp-qr-login 工具完成初始引导。
• 用户名/密码（会话抓取） — 设置 CANVAS_USERNAME 与 CANVAS_PASSWORD。仅适用于直接注册的 Canvas 账户（不支持 SSO 或 2FA），稳定性较差。

当多个认证方式同时配置时，优先级顺序为：CANVAS_TOKEN > 用户名/密码 > OAuth > fetchproxy。如需禁用 fetchproxy 回退机制，请设置 CANVAS_DISABLE_FETCHPROXY=1。

工具集（命令前缀均为 canvas_）

个人资料与被观察者（observees）

• canvas_get_profile — 获取您的 Canvas 个人资料
• canvas_list_observees — 列出与您的观察者账户关联的学生

课程

• canvas_list_courses — 列出您当前参与的课程及其成绩
• canvas_get_course(courseId) — 获取指定课程详情（含教学大纲与任课教师信息）

作业与提交记录

• canvas_list_assignments(courseId) — 列出某门课程中的全部作业
• canvas_list_missing_submissions — 列出已逾期但尚未提交的作业
• canvas_get_submission(courseId, assignmentId) — 获取您针对某项作业的提交详情（含教师评语与评分细则 rubric）
• canvas_list_recent_submissions(courseId) — 列出某门课程中最近已批阅的提交记录（默认时间范围为过去 14 天）

成绩

• canvas_list_enrollments — 按课程列出成绩信息

日历与日程规划

• canvas_list_calendar_events — 列出日历事件与作业截止提醒
• canvas_list_upcoming_events — 获取服务器聚合整理的未来 7 天日程
• canvas_list_planner_items — 获取统一整合的待办事项流（to-do feed）

通信

• canvas_list_announcements(contextCodes) — 获取指定上下文（如课程）的公告
• canvas_list_conversations — 获取收件箱中的全部会话
• canvas_get_conversation(id) — 获取指定 ID 的完整会话线程
• canvas_list_discussion_topics(courseId) — 获取某门课程下的全部讨论主题

文件

• canvas_list_course_files(courseId) — 获取某门课程的文件元数据
• canvas_download_file(url, destinationPath) — 将指定 URL 的文件下载至本地磁盘路径

注意事项

• 若希望使用比 CANVAS_BASE_URL 主机名更友好的显示名称，请设置 CANVAS_NAME。
• 所有面向用户的只读工具均支持可选参数 observeeId（默认值为 self），便于观察者账户查看其所关联学生的相关信息。