🚀 学校 MCP

一个用于学术工具的模型上下文协议（MCP）服务器，它与Canvas和Gradescope平台集成，能帮助用户更高效地管理学术事务，如获取作业截止日期、集成日历以及管理课程文件等。

🚀 快速开始

📦 安装指南

通过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 Integration Guide配置Claude Desktop。

运行服务器

直接运行：

python -m school_mcp

或者使用方便的脚本：

./run_server.py

✨ 主要特性

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

💻 使用示例

基础用法

以下是一些常用工具的使用示例：

# 获取即将到来的作业截止日期
python -m school_mcp get_deadlines

# 将作业添加到macOS Reminders
python -m school_mcp add_to_reminders

# 列出所有可用的Canvas课程
python -m school_mcp list_courses

# 从Canvas课程下载文件
python -m school_mcp download_course_files

# 配置文件保存的位置
python -m school_mcp set_download_path /your/download/path

# 检查当前下载位置
python -m school_mcp get_download_path_info

🔧 技术细节

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

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

📄 许可证

本项目采用MIT许可证。