School MCP

🚀 學校 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許可證。