Canvas MCP

🚀 Canvas 画布 MCP サーバーアシスタント

このツールは、LLM（例：Claude Desktop）を離れることなく、Canvas/Instructure のコースや課題とやり取りできるようにするモデルコンテキストプロトコル（MCP）サーバーです。プログラムでコースや課題の情報を取得、検索、要約でき、例えば期限が近い課題の締め切り日を確認できます。

🚀 クイックスタート

この Canvas サーバーアシスタントを使うことで、LLM 内で Canvas のコースや課題にアクセスできます。以下の手順でセットアップしてください。

✨ 主な機能

ツール

1. コースの一覧表示
   • コースのリストを取得します。
   • コースの状態（アクティブ、完了、またはすべて）でフィルタリングできます。
2. 課題の検索
   • すべてのコースで課題を検索します。
   • 以下のフィルターが利用可能です：
     • 検索クエリ
     • 締め切り日の範囲
     • 特定のコース
     • 完了したコースの含む/除外
3. 課題の詳細情報の取得
   • 特定の課題の詳細情報を取得します。
   • 複数の出力形式（完全な HTML、純粋なテキスト、Markdown）があります。

リソース

• 課題内容：統一資源識別子形式で完全な課題の詳細情報を取得します。

📦 インストール

前提条件

• Node.js
• Canvas LMS アカウント
• Canvas API トークン
• Canvas ベースライン

環境設定

以下の環境変数を設定してください：

• CANVAS_API_TOKEN：あなたの Canvas API アクセストークン（下記の説明を参照）
• CANVAS_DOMAIN：あなたの Canvas 機関のドメイン名（例：canvas.youruniversity.edu）

Canvas API トークンの取得方法

1. Canvas にログインします。
2. アカウント > 設定に移動します。
3. 「承認済みの統合」セクションまでスクロールします。
4. 「新しいアクセストークン」をクリックします。
5. 生成されたトークンをコピーします。

詳細については、Canvas のこれらの説明を参照してください。

セキュリティに関する注意事項

CANVAS_API_TOKEN は機密情報です。バージョン管理には登録しないでください。

インストール手順

1. リポジトリをクローンし、依存関係をインストールする リポジトリをクローンします。

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

   依存関係をインストールします。エラーが発生した場合は、node がインストールされていることを確認してください。

   npm install
   

2. MCP サーバーに接続する 以下の JSON をコピーし、適切な {{PATH}} 値を置き換えてください。

   {
     "mcpServers": {
       "canvas": {
         "command": "node", 
         "args": ["/absolute/path/to/canvas-mcp/src/index.ts"], // src リポジトリに入り、`pwd` を実行して出力をここに入力
         "env": {
           "CANVAS_API_TOKEN": "your_api_token_here",
           "CANVAS_DOMAIN": "myschool.instructure.com"
         }
       }
     }
   }
   

   Claude の場合は、このファイルを claude_desktop_config.json として Claude Desktop の設定ディレクトリに保存します。

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

   Cursor の場合は、このファイルを mcp.json として Cursor の設定ディレクトリに保存します。

   ~/.cursor/mcp.json
   

3. Claude Desktop / Cursor を再起動する Claude Desktop を開くと、Canvas が利用可能な統合として表示されるはずです。

💻 使用例

MCP ツール

• canvas：Canvas プラットフォームに接続し、コースや課題の情報を取得、課題を提出するなどの様々な操作を実行します。

トラブルシューティング

問題が発生した場合は、以下を確認してください：

• Node.js と依存関係が正しくインストールされていることを確認します。
• API トークンとドメイン名が正しく設定されていることを確認します。
• コンソール出力を確認して、詳細なエラー情報を取得します。

📄 ライセンス

このプロジェクトは、Canvas プラットフォームとやり取りするための基本的なツールを提供することを目的としています。使用する前に、関連するドキュメントをよく読み、Canvas のサービス利用規約とプライバシーポリシーを遵守することを確認してください。