Canvas MCP Server

Canvas MCP サーバー

Canvas LMS API 用の Model Context Protocol（MCP）サーバー実装です。このサーバーを使用すると、Canvas LMS とプログラムからやり取りできます。

機能

• 登録タイプで任意に絞り込みながら、Canvas LMS のコースを一覧表示
• ツールの使い方を案内する対話型ヘルププロンプト

前提条件

• Node.js 18 以降
• Canvas LMS インスタンス
• Canvas API アクセストークン
• Cursor（クライアント連携用）

セットアップ

1. このリポジトリをクローンします
2. 依存関係をインストールします：

   npm install
   

3. 環境変数を設定します：

   export CANVAS_BASE_URL="https://your-canvas-instance.com"
   export CANVAS_ACCESS_TOKEN="your-api-token"
   

4. プロジェクトをビルドします：

   npm run build
   

5. サーバーを起動します：

   npm start
   

Cursor との接続

この MCP サーバーを Cursor で使用するには：

1. Cursor の設定を開きます
2. MCP 設定セクションに移動します
3. 新しいサーバー設定を追加します：

   {
     "mcpServers": {
       "canvas": {
         "command": "npm",
         "args": [
           "start"
         ],
         "cwd": "/path/to/mcp-server-canvas"
       }
     }
   }
   

4. 設定を保存し、Cursor を再起動します
5. Canvas ツールが Cursor の MCP ツールパネルで使用できるようになります

利用可能なツール

list_courses

Canvas LMS のすべてのコースを一覧表示します。

パラメーター：

• enrollment_type（任意）：登録タイプ（teacher、student、ta）でコースを絞り込みます

レスポンス例：

{
  "content": [
    {
      "type": "text",
      "text": [
        {
          "id": 1234,
          "name": "Example Course",
          "code": "EX101",
          "state": "available",
          "startDate": "2024-01-01T00:00:00Z",
          "endDate": "2024-12-31T23:59:59Z"
        }
      ]
    }
  ]
}

list-courses-help

list_courses ツールの使い方を案内する対話型プロンプトです。

開発

このサーバーは TypeScript と MCP SDK を使用して構築されています。新しい機能を追加するには：

1. CanvasAPI クラスに新しい API メソッドを追加します
2. server.tool() を使用して新しいツールを登録します
3. server.prompt() を使用してヘルププロンプトを登録します
4. 変更をビルドしてテストします

トラブルシューティング

問題が発生した場合：

1. 環境変数が正しく設定されていることを確認します
2. Canvas API トークンに必要な権限があることを確認します
3. Cursor の MCP サーバーログでエラーメッセージを確認します
4. Cursor の設定でサーバーのパスが正しいことを確認します

ライセンス

MIT