学校 MCP

一个用于学术工具的模型上下文协议（MCP）服务器，集成了 Canvas 和 Gradescope 平台。

功能

• 作业截止日期：从 Canvas 和 Gradescope 获取并显示即将到来的截止日期
• 日历集成：使用 AppleScript 将截止日期添加到 macOS 日历或提醒事项中
• 文件管理：从 Canvas 下载课程材料

快速开始

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Claude Desktop 的 School MCP：

npx -y @smithery/cli install @54yyyu/school-mcp --client claude

1. 克隆仓库：

git clone https://github.com/yourusername/school-mcp.git
cd school-mcp

1. 安装包：

pip install -e .

1. 设置环境变量，可以通过以下两种方式之一进行：
   • 使用包含的设置助手（推荐）
   • 手动创建 .env 文件

使用设置助手

运行设置助手以自动配置 Claude Desktop：

python setup_helper.py

设置助手将：

• 查找你的 Claude Desktop 配置文件
• 如果需要，创建一个 .env 文件
• 使用正确的路径配置 MCP 服务器
• 将环境变量添加到 Claude Desktop 配置中

手动设置

如果你更喜欢手动设置：

1. 复制环境模板：

cp .env.template .env
# Edit .env with your credentials

1. 按照 Claude Desktop 集成指南配置 Claude Desktop。

运行服务器

直接运行：

python -m school_mcp

或者使用便捷脚本：

./run_server.py

工具

• get_deadlines：从 Canvas 和 Gradescope 获取即将到来的作业截止日期
• add_to_reminders：将作业添加到 macOS 提醒事项
• list_courses：列出所有可用的 Canvas 课程
• download_course_files：从 Canvas 课程下载文件
• set_download_path：配置下载文件的保存位置
• get_download_path_info：检查当前的下载位置

配置

服务器按以下顺序查找配置：

1. 环境变量
2. 当前目录中的 .env 文件
3. 主目录中的现有 config.json 文件

许可证

MIT