Canvas 画布 MCP 服务器助手

概述

此模型上下文协议（MCP）服务器让您能够在不离开您的 LLM（例如 Claude Desktop）的情况下与 Canvas/Instructure 课程和作业进行交互。

它允许您以编程方式检索、搜索和总结课程和作业信息，例如检查即将到期的作业的截止日期：

特性

工具

1. 列出课程

   • 检索课程列表
   • 根据课程状态（活动、已完成或所有）进行筛选

2. 搜索作业

   • 在所有课程中搜索作业
   • 过滤器包括：
     • 搜索查询
     • 截止日期范围
     • 特定课程
     • 包括/排除已完成的课程

3. 获取作业详细信息

   • 获取特定作业的详细信息
   • 多种输出格式（完整的 HTML、纯文本、Markdown）

资源

• 作业内容：使用统一资源标识符格式检索完整的作业详细信息

先决条件

• Node.js
• Canvas LMS 帐户
• Canvas API 令牌
• Canvas 基准

环境设置

设置以下环境变量：

• CANVAS_API_TOKEN：您的 Canvas API 访问令牌（请参见下方说明）
• CANVAS_DOMAIN：您的 Canvas 机构的域名（例如，canvas.youruniversity.edu）

如何获取您的 Canvas API 令牌

1. 登录到 Canvas
2. 转到帐户 > 设置
3. 滚动到“批准的集成”部分
4. 点击“新建访问令牌”
5. 复制生成的令牌

有关更多详细信息，请参阅 Canvas 的这些说明。

安全注意事项

保持您的 CANVAS_API_TOKEN 机密。不要将其提交到版本控制。

安装

1. 克隆仓库并安装依赖项

克隆仓库

git clone https://github.com/mbcrosier/canvas-mcp.git
cd canvas-mcp

安装依赖项。如果出现错误，请确保您已安装 node。

npm install

2. 连接到 MCP 服务器

   复制以下 JSON 并用适当的 {{PATH}} 值替换：

   {
     "mcpServers": {
       "canvas": {
         "command": "node", 
         "args": ["/absolute/path/to/canvas-mcp/src/index.ts"], // 进入 src 仓库，运行 `pwd` 并在此处输入输出内容
         "env": {
            "CANVAS_API_TOKEN": "your_api_token_here",
            "CANVAS_DOMAIN": "myschool.instructure.com"
          }
       }
     }
   }
   

   对于 Claude，将此文件保存为 claude_desktop_config.json 在您的 Claude Desktop 配置目录中：

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

   对于 Cursor，将此文件保存为 mcp.json 在您的 Cursor 配置目录中：

   ~/.cursor/mcp.json
   

3. 重新启动 Claude Desktop / Cursor

   打开 Claude Desktop，您现在应该看到 Canvas 作为可用集成。

MCP 工具

• canvas：用于连接到 Canvas 平台并执行各种操作，例如检索课程和作业信息、提交作业等。

故障排除

• 如果遇到问题，请检查以下内容：
  • 确保 Node.js 和依赖项已正确安装。
  • 确保 API 令牌和域名设置正确。
  • 查看控制台输出以获取更多错误详细信息。

免责声明

本项目旨在提供一个与 Canvas 平台交互的基础工具。使用前请仔细阅读相关文档并确保遵守 Canvas 的服务条款和隐私政策。