Canvas LMS MCP Server

Model Context Protocol サーバーで、MCP クライアント（Claude Desktop、Claude Code、その他 MCP を話せるものなら何でも）に Canvas LMS アカウントへの読み取り専用アクセスを提供します。

次の2つの質問に答えます：

• 「何を受講していて、成績はどうか？」 — 現在の成績が付いているアクティブなコース。

• 「まだ提出していないものは何で、いつ締切か？」 — 期限が設定されている未提出の課題。

通信は標準の stdio トランスポートを使用するため、クライアントはサーバーをサブプロセスとして起動します。MCP トラフィック以外は stdout に書き込まれません。

要件

• Node.js 18.17 以降（サーバーは組み込みの fetch を使用）

• Canvas の個人アクセストークン

Related MCP server: Canvas MCP Server

インストール

cd canvas-mcp-server
npm install

設定

両方の変数が必須です。どちらかが欠けている場合、サーバーは明確なメッセージを表示して終了します。

Canvas アクセストークンの取得

1. Canvas にログインします。

2. Account → Settings に移動します。

3. Approved Integrations の下にある + New Access Token をクリックします。

4. 目的を入力し、（任意で）有効期限を設定して、Generate Token をクリックします。

5. トークンをすぐにコピーします — Canvas は一度しか表示しません。

このトークンは Canvas のすべての権限を持ちます。バージョン管理には含めず、漏洩した場合は同じ設定ページから失効させてください。

クライアントの接続

MCP クライアント設定にサーバーを追加し、src/index.js の絶対パスを指定します：

{
  "mcpServers": {
    "canvas": {
      "command": "node",
      "args": ["/absolute/path/to/canvas-mcp-server/src/index.js"],
      "env": {
        "CANVAS_API_URL": "https://asu.instructure.com",
        "CANVAS_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

• Claude Desktop — claude_desktop_config.json （macOS: ~/Library/Application Support/Claude/、Windows: %APPDATA%\Claude\）。

• Claude Code — claude mcp add canvas --env CANVAS_API_URL=... --env CANVAS_ACCESS_TOKEN=... -- node /absolute/path/to/canvas-mcp-server/src/index.js

設定を編集したらクライアントを再起動します。

ツール

list_courses_and_grades

学生としてアクティブに登録されているすべてのコースと、その現在の成績。

あなたの機関が grading period を使用している場合、Canvas は成績を2回報告します。進行中の period のものと、コース全体のものです。grades.scope フィールドはどちらを見ているかを示します：

• current_grading_period — スコアは進行中の grading period を対象としており、course_total_score / course_total_grade にはコース全体の数値が入ります。

• course_total — 機関が grading period を使用していないため、スコアはコース合計です。

• unavailable — Canvas が成績データ付きの登録を返しませんでした。

どちらのスコープでも、current_* はまだ採点されていない課題を無視しますが、final_* は未採点の課題をゼロとして数えます。

{
  "courses": [
    {
      "id": "101",
      "name": "Full Stack Web Development",
      "course_code": "GIT-411",
      "term": "Fall 2026",
      "term_start": "2026-08-20T00:00:00Z",
      "term_end": "2026-12-18T00:00:00Z",
      "enrollment_state": "active",
      "grades": {
        "current_score": 88.0,
        "current_grade": "B+",
        "final_score": 80.5,
        "final_grade": "B-",
        "scope": "current_grading_period",
        "grading_period_title": "Fall Term",
        "course_total_score": 91.4,
        "course_total_grade": "A-"
      },
      "html_url": "https://asu.instructure.com/courses/101"
    }
  ],
  "course_count": 1,
  "retrieved_at": "2026-09-01T12:00:00.000Z"
}

list_upcoming_assignments

アクティブなコース全体でまだ未提出の課題を、期限日順（早い順）に並べたもの。

課題は、公開され、採点可能で、未提出・未採点・未免除の場合に未提出としてカウントされます。具体的には、以下は除外されます：

• 提出タイムスタンプがあるもの

• submitted、pending_review、または graded 状態の提出

• 免除された課題

• すでにスコアまたは成績が付いている課題（手動または紙ベースの入力）

• not_graded の課題（出席プレースホルダーなど）

• 非公開の課題

{
  "assignments": [
    {
      "id": "9004",
      "name": "Missed lab writeup",
      "course_id": "101",
      "course_name": "Full Stack Web Development",
      "due_at": "2026-08-28T06:59:00.000Z",
      "days_until_due": -4.2,
      "overdue": true,
      "points_possible": 25,
      "submission_types": ["online_upload"],
      "submission_state": "unsubmitted",
      "missing": true,
      "locked": false,
      "unlock_at": null,
      "lock_at": null,
      "html_url": "https://asu.instructure.com/courses/101/assignments/9004"
    }
  ],
  "assignment_count": 1,
  "courses_checked": 2,
  "window": {
    "from": "2026-09-01T12:00:00.000Z",
    "to": "2026-09-15T12:00:00.000Z",
    "include_overdue": true,
    "include_undated": false
  },
  "errors": [],
  "retrieved_at": "2026-09-01T12:00:00.000Z"
}

1つのコースが読み取れない場合 — 終了済み、制限付き、その他のエラー — そのコースは errors にリストされ、残りのコースは結果を返し続けます。

動作に関する注意

• ページネーション。 Canvas はすべてのコレクションを Link ヘッダーでページ分割します。クライアントはエンドポイントごとに100レコードずつ rel="next" をたどり、最大20ページまでで打ち切るため、不正なレスポンスが無限ループを引き起こすことはありません。

• 並行性。 Canvas のレート制限を避けるため、課題は最大5コースから同時に取得されます。

• 現在のターム。 デフォルトでは、タームが終了していないコースのみが返されます。Canvas のデフォルトタームには終了日がなく、常に含まれます。

• エラー。 Canvas の失敗は、ステータスコードと Canvas 自身のメッセージを含む MCP ツールエラーとして返され、一般的なケース（401 → トークン不正、404 → URL 誤り）のヒントが付きます。

• 読み取り専用。 両方のツールは readOnlyHint で注釈されています。サーバーは GET リクエストのみを発行し、Canvas データを変更することはありません。

開発

npm test    # 36 tests: API client, grade logic, filtering, and an end-to-end MCP round trip

テストスイートは記録された Canvas ペイロードを持つ fetch の代替を使用するため、ネットワークや実際のトークンは不要です。すべてのフィクスチャの日付は、テストが実行される時点を基準にしています。

src/
  index.js        MCP server: tool definitions, schemas, stdio wiring
  canvas.js       Canvas REST client: auth, pagination, error mapping
  courses.js      Active-course and grade normalization
  assignments.js  Outstanding-assignment filtering and due-date windows

ライセンス

MIT