School MCP

School MCP

site icon
2025.03.31 3
Python学术工具作业管理课程管理开发效率
School MCP 是一个专为学术工具设计的 Model Context Protocol (MCP) 服务器,主要集成 Canvas 和 Gradescope 平台,提供作业截止日期管理、日历集成和课程文件管理等功能。
View on GitHub

Overview

基本能力

产品定位

School MCP 是一个专为学术工具设计的 MCP 服务器,旨在帮助学生和教师更高效地管理学术任务和课程材料。

核心功能

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

适用场景

  • 学生需要集中管理多个学习平台的作业截止日期。
  • 教师需要快速下载和分发课程材料。
  • 用户希望将学术任务集成到 macOS 日历或提醒事项中。

工具列表

  • 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 文件。

使用教程

使用依赖

  • 需要安装 Python 和 pip。

安装教程

通过 Smithery 安装

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. 设置环境变量:
  2. 使用设置助手(推荐):
python setup_helper.py
  • 或手动创建 .env 文件:
cp .env.template .env
# 编辑 .env 文件填写凭据

调试方式

运行服务器:

python -m school_mcp

或使用便利脚本:

./run_server.py

许可证

该项目遵循 MIT 开源许可条款。