项目介绍
School MCP
这是一个用于学术工具的模型上下文协议（MCP）服务器，与Canvas和Gradescope平台集成。
功能
- 作业截止日期：从Canvas和Gradescope获取并显示即将到期的截止日期。
- 日历集成：使用AppleScript将截止日期添加到macOS日历或提醒事项中。
- 文件管理：从Canvas下载课程材料。
快速开始
安装
通过Smithery安装
要通过Smithery自动安装School MCP for Claude Desktop：
npx -y @smithery/cli install @54yyyu/school-mcp --client claude
- 克隆仓库：
git clone https://github.com/yourusername/school-m
cd school-mcp
- 安装包：
pip install -e .
- 设置环境变量，可以通过以下方式之一：
- 使用包含的设置助手（推荐）
- 手动创建一个
.env文件
使用设置助手
运行设置助手以自动配置Claude Desktop：
python setup_helper.py
设置助手会：
- 查找你的Claude Desktop配置文件
- 如果需要，创建一个
.env文件 - 使用正确的路径配置MCP服务器
- 将环境变量添加到Claude Desktop配置中
手动设置
如果你更喜欢手动设置：
- 复制环境模板：
cp .env.template .env
# 编辑.env文件，填写你的凭证
- 按照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：检查当前的下载位置。
配置
服务器按以下顺序查找配置：
- 环境变量
- 当前目录中的
.env文件 - 家目录中存在的
config.json文件
许可证
MIT
</中文翻译>