School MCP

🚀 学校MCP

学校MCPは、CanvasやGradescopeなどの学術用プラットフォームと統合された、学術ツール用のモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• 課題締切日：CanvasとGradescopeからupcomingの締切日を取得して表示します。
• カレンダー統合：AppleScriptを使って、締切日をmacOSのCalendarまたはRemindersに追加します。
• ファイル管理：Canvasから講義資料をダウンロードします。

🚀 クイックスタート

📦 インストール

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

💻 使用例

基本的な使用法

以下のコマンドを使用して、各種機能を実行できます。

# 以下は各種コマンドの使用例です
# 締切日を取得する
python -m school_mcp get_deadlines
# 作業をmacOSのリマインダーに追加する
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
# 現在のダウンロード場所を確認する
python -m school_mcp get_download_path_info

🔧 技術詳細

サーバーは以下の順序で設定を探します。

1. 環境変数
2. 現在のディレクトリ内の.envファイル
3. ユーザーのホームディレクトリ内の既存のconfig.jsonファイル

📄 ライセンス

MITライセンスの下で提供されています。