School 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

2. 安装包：

pip install -e .

3. 通过以下方式设置您的环境变量：
   • 使用包含的设置助手（推荐）
   • 手动创建 .env 文件

使用设置助手

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

python setup_helper.py

设置助手将：

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

手动设置

如果您更喜欢手动设置：

1. 复制环境模板：

cp .env.template .env
# 使用您的凭据编辑 .env

2. 按照 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