Canvas Learning Management System

🚀 Canvas MCP サーバー

このリポジトリには、Canvas 学習管理システム (LMS) API と接続するためのメッセージ制御プロトコル (MCP) サーバーの実装が含まれています。このサーバーは、Claude Desktop やその他の潜在的な MCP クライアントと共に使用することを目的としています。

🚀 クイックスタート

Canvas MCP サーバーを使用することで、Canvas LMS API へのローカルインターフェースを通じて、様々な操作を行うことができます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

Canvas MCP サーバーは、以下の機能を提供します。

• コースの一覧表示と管理
• 課題と提出物のアクセス
• 公告の閲覧
• コースの大綱とモジュールの取得
• ユーザーと登録情報の管理
• コースの要約生成

📦 インストール

前提条件

• Python 3.x
• 仮想環境 (venv)
• Canvas API トークン
• Canvas API URL（例: https://canvas.illinois.edu/api/v1）

インストール手順

1. このリポジトリをクローンします。

git clone https://github.com/vishalsachdev/canvas-mcp.git
cd canvas-mcp

2. 仮想環境を作成し、アクティブ化します。

python -m venv canvas-mcp
source canvas-mcp/bin/activate  # Unix/macOS の場合

3. 依存関係をインストールします。

pip install -r requirements.txt

4. MCP サーバーをインストールします。

pip install .

📚 ドキュメント

設定

1. 環境ファイルの作成

ルートディレクトリに .env ファイルを作成し、以下の変数を含めます。

CANVAS_API_TOKEN=your_canvas_api_token_here
CANVAS_API_URL=https://canvas.youruniversity.edu/api/v1

以下の値を実際の値に置き換えてください。

• あなたの Canvas API トークン（Canvas API トークンの取得方法）
• あなたの機関の Canvas API URL

2. 起動スクリプトの設定

start_canvas_server.sh スクリプトは、以下のように設定されています。

• .env ファイルから環境変数を読み込む
• 仮想環境を起動する
• キャッシュサーバーの実装を実行する

起動スクリプトを実行可能にします。

chmod +x start_canvas_server.sh

3. Claude Desktop の設定

1. まだインストールされていない場合は、Claude Desktop をダウンロードしてインストールします。
2. Claude アプリを開き、Settings（設定）に移動します。
3. 左側のメニューで Environment Variables（環境変数）を選択します。
4. 以下の変数を追加します。
   • 名前：CANVAS_API_TOKEN 値：あなたの Canvas API トークン
   • 名前：CANVAS_API_URL 値：あなたの機関の Canvas API URL

サーバーの使用

MCP サーバーを起動します。

python -m canvas_mcp.server

セキュリティに関する考慮事項

• あなたの Canvas API トークンは、あなたの Canvas アカウントへのアクセス権を付与します。
• .env ファイルをバージョン管理システムにコミットしないでください。
• 可能であれば、権限が制限されたトークンを使用することを検討してください。
• このサーバーはあなたのローカルコンピュータ上で実行され、あなたの資格情報は外部に公開されません。

貢献

貢献を歓迎します！以下のことを自由に行ってください。

• 問題を報告して、バグや機能要求を提出する
• プロジェクトを改善するためのプルリクエストを作成する
• あなたの使用例やフィードバックを共有する

📄 ライセンス

このプロジェクトは MIT ライセンスを使用しています。詳細については、LICENSE ファイルを参照してください。

作成者: Vishal Sachdev