MCP 服务器

Canvas MCP Server

使像 Claude 这样的人工智能助手能够通过 Canvas API 与 Canvas LMS 互动，从而提供管理课程、公告、评分标准、作业和学生数据的工具。

README

Canvas MCP 服务器

一个模型上下文协议 (MCP) 服务器，使像 Claude 这样的 AI 助手能够与 Canvas LMS 交互。该服务器提供通过 Canvas API 管理课程、公告、评分标准、作业和学生数据的工具。

功能

列出活跃课程及其详细信息
向课程发布公告
查看课程评分标准
获取学生注册信息
访问作业详细信息和提交内容
查看学生提交历史和评论

前提条件

Node.js (v16 或更高版本)
一个 Canvas API 令牌
Canvas 实例 URL (默认为 "https://fhict.instructure.com")

安装

克隆此存储库并安装依赖项：

git clone <repository-url>
cd canvas-mcp
npm install

构建 TypeScript 项目：
```
npm run build
```

配置您的环境变量：

# 创建一个 .env 文件
echo "CANVAS_API_TOKEN=your_token_here" > .env
# 可选：设置自定义 Canvas URL
echo "CANVAS_DOMAIN=https://your-canvas-instance.com" >> .env

Claude Desktop 集成

打开 Claude Desktop 的配置文件：

MacOS:

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

Windows:

code %AppData%\Claude\claude_desktop_config.json

添加 Canvas MCP 服务器配置：

{
  "mcpServers": {
    "canvas": {
      "command": "node",
      "args": [
        "/path/to/canvas-mcp/build/index.js"
      ],
      "env": {
        "CANVAS_API_TOKEN": "your_token_here",
        "CANVAS_DOMAIN": "https://your-canvas-instance.com"
      }
    }
  }
}

重启 Claude Desktop 以应用更改

可用工具

list-courses

列出已验证用户的所有活跃课程

无需参数
返回课程名称、ID 和学期信息

post-announcement

向特定课程发布公告

必需参数：
- courseId: string
- title: string
- message: string

list-rubrics

列出特定课程的所有评分标准

必需参数：
- courseId: string
返回评分标准标题、ID 和描述

list-students

获取注册课程的完整学生列表

必需参数：
- courseId: string
可选参数：
- includeEmail: boolean (默认值: false)
返回学生姓名、ID 和可选的电子邮件地址

list-assignments

获取课程中所有作业的提交状态

必需参数：
- courseId: string
可选参数：
- studentId: string
- includeSubmissionHistory: boolean (默认值: false)
返回作业详细信息和提交状态

list-assignment-submissions

获取特定作业的所有学生提交内容

必需参数：
- courseId: string
- assignmentId: string
可选参数：
- includeComments: boolean (默认值: true)
返回提交详细信息、成绩和评论

可用提示

analyze-rubric-statistics

分析课程中形成性作业的评分标准统计数据并创建可视化效果

必需参数：
- courseName: string (要分析的课程名称)
创建两个综合可视化效果：
1. 分组堆叠条形图，显示所有作业中每个标准的得分分布
2. 分组条形图，显示所有作业中每个标准的平均得分
提供跨作业和标准的比较分析
包括进展分析和趋势识别

故障排除

常见问题

服务器未出现在 Claude Desktop 中：
- 验证配置文件语法
- 检查文件路径是否为绝对路径
- 确保 Canvas API 令牌有效
- 重启 Claude Desktop
连接错误：
- 检查 Canvas API 令牌权限
- 验证 Canvas 实例是否可访问
- 查看 Claude 的 MCP 日志：
```
# MacOS
tail -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %AppData%\Claude\Logs\mcp*.log
```