School MCP

School MCP

Canvas および Gradescope プラットフォームと連携する、学術向けツールの Model Context Protocol（MCP）サーバーです。

機能

• 課題の締め切り：Canvas および Gradescope から今後の締め切りを取得して表示します
• カレンダー連携：AppleScript を使用して、macOS のカレンダーまたはリマインダーに締め切りを追加します
• ファイル管理：Canvas からコース教材をダウンロードします

クイックスタート

インストール

Smithery 経由でインストール

Smithery 経由で School MCP を Claude Desktop に自動インストールするには：

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
# Edit .env with your credentials

2. Claude Desktop Integration Guide に従って Claude Desktop を設定します。

サーバーの実行

直接実行します：

python -m school_mcp

または、便利なスクリプトを使用します：

./run_server.py

CLI：cw／coursework

pip install -e . を実行すると、コマンドラインツール cw（正式名称は coursework）もインストールされます：

cw deadlines                 # unsubmitted work due in the next 14 days (Canvas + Gradescope)
cw deadlines -s canvas -d 7  # Canvas only, next week
cw announcements -u          # unread course announcements
cw inbox -u                  # unread Canvas inbox conversations
cw message 512758            # read a thread (does not mark it read)
cw grades 20.201             # per-assignment scores for one course
cw files 6.7810 --compare ~/Desktop/MIT/6.7810 --missing   # what's not filed locally yet
cw download crispr           # download a course's files (or --id ID ... for a selection)
cw use columbia              # switch the active account

コースはコード、名前の一部、または Canvas ID で指定できます。すべてのコマンドで -h、--json、および（学校と通信する場合は）-a ACCOUNT を使用できます。

CLI 用の Claude Code スキルは skill/coursework/ にあります。すべてのセッションで使用できるようにするには、 ~/.claude/skills/ にシンボリックリンクを作成してください。

MCP ツール

• 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