Skip to main content
Glama

Canvas MCP サーバー

Canvas APIと連携するためのモデルコンテキストプロトコル(MCP)サーバー。このサーバーを使用すると、Canvas内でコース、課題、登録、成績を管理できます。

前提条件

  • Node.js : バージョン18以上

  • Canvas APIトークン: Canvasアカウントから取得

  • Canvas ドメイン: 通常は、 canvas.instructure.com

Related MCP server: Canvas MCP

設定

  1. リポジトリのクローンを作成する

    git clone https://github.com/yourusername/canvas-mcp-server.git
    cd canvas-mcp-server
    
  2. 依存関係をインストールする

    npm install
  3. 環境変数を設定する

サンプル環境ファイルをコピーします。

cp .env.example .env

.env を編集し、プレースホルダーの値を実際の Canvas API トークンとドメインに置き換えます。

プロジェクトを構築する

npm run build
  1. サーバーを実行する

    npm start

    サーバーが起動し、stdio 経由で MCP 要求をリッスンします。

Claudeデスクトップに接続しています

  1. クロードの設定を更新する

    MCP サーバー構成を claude_desktop_config.json に追加します。

  "canvas-mcp-server": {
      "command": "npx",
      "args": ["-y", "canvas-mcp-server"]
    },

Claudeデスクトップを再起動します

Claude Desktopを完全に終了してください。Claude Desktopを再起動してください。🔌メニューに移動して、Canvas MCPサーバーを見つけて接続してください。

利用可能なツール(学生向けのツールも近日中に追加予定)

  • canvas_create_course : Canvas に新しいコースを作成します。

  • canvas_update_course : Canvas 内の既存のコースを更新します。

  • canvas_create_assignment : Canvas コースに新しい課題を作成します。

  • canvas_update_assignment : 既存の課題を更新します。

  • canvas_submit_grade : 生徒の課題の成績を送信します。

  • canvas_enroll_user : ユーザーをコースに登録します。

エラー処理

ツールは、問題が発生した場合にisError: trueというエラーメッセージを返します。実行時エラーを回避するために、必要な環境変数がすべて設定されていることを確認してください。

トラブルシューティング

  • ビルド エラー:

TypeScript のバージョンを確認します: npx tsc --version クリーンしてリビルドします: rm -rf build/ && npm run build

  • ランタイムエラー:

    詳細なエラーメッセージについてはログを確認してください。環境変数が正しく設定されていることを確認してください。

  • 型エラー:

    TypeScriptの型チェックを使用して型を検証する: npx tsc --noEmit

貢献

貢献を歓迎します!改善やバグ修正については、問題を報告したり、プルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。


追加情報

  • 型安全性: types.tsファイルは、Canvas API とのすべてのやり取りが型安全であることを保証し、実行時エラーを削減し、コードの保守性を向上させます。

  • エラー処理: サーバーは、 isErrorフラグを使用して意味のあるメッセージを返すことでエラーを適切に処理し、クライアント (Claude Desktop など) がエラーを理解して適切に対応できるようにします。

  • 環境変数: API トークンなどの機密情報は環境変数を通じて管理され、さまざまな環境にわたるセキュリティと柔軟性が向上します。

  • モジュール性: 関心事を異なるファイル ( types.ts 、 client.ts 、 index.ts ) に分割すると、コードベースのナビゲートと保守が容易になります。

プロジェクトの具体的なニーズに合わせて、ファイルパスや設定を自由に調整してください。さらにサポートが必要な場合はお知らせください。

Available Tools

54 tools
canvas_create_account_reportC

Generate a report for an account

Inputs: account_id (required), report (required), parameters.

canvas_create_assignmentC

Create a new assignment in a Canvas course

Inputs: course_id (required), name (required), allowed_extensions, description, +4 more.

canvas_create_conversationC

Create a new conversation

Inputs: body (required), recipients (required), subject.

canvas_create_courseC

Create a new course in Canvas

Inputs: account_id (required), name (required), allow_student_forum_attachments, allow_student_wiki_edits, +20 more.

canvas_create_quizC

Create a new quiz in a course

Inputs: course_id (required), title (required), description, due_at, +3 more.

canvas_create_userC

Create a new user in an account

Inputs: account_id (required), pseudonym (required), user (required).

canvas_enroll_userC

Enroll a user in a course

Inputs: course_id (required), user_id (required), enrollment_state, role.

canvas_get_accountC

Get account details

Inputs: account_id (required).

canvas_get_account_reportsC

List available reports for an account

Inputs: account_id (required).

canvas_get_assignmentC

Get detailed information about a specific assignment

Inputs: assignment_id (required), course_id (required), include_submission.

canvas_get_conversationB

Get details of a specific conversation

Inputs: conversation_id (required).

canvas_get_courseC

Get detailed information about a specific course

Inputs: course_id (required).

canvas_get_course_gradesC

Get grades for a course

Inputs: course_id (required).

canvas_get_dashboardC

Get user's dashboard information

Inputs: no named parameters.

canvas_get_dashboard_cardsB

Get dashboard course cards

Inputs: no named parameters.

canvas_get_discussion_topicC

Get details of a specific discussion topic

Inputs: course_id (required), topic_id (required).

canvas_get_fileC

Get information about a specific file

Inputs: file_id (required).

canvas_get_moduleC

Get details of a specific module

Inputs: course_id (required), module_id (required).

canvas_get_module_itemB

Get details of a specific module item

Inputs: course_id (required), item_id (required), module_id (required).

canvas_get_pageB

Get content of a specific page

Inputs: course_id (required), page_url (required).

canvas_get_quizC

Get details of a specific quiz

Inputs: course_id (required), quiz_id (required).

canvas_get_rubricC

Get details of a specific rubric

Inputs: course_id (required), rubric_id (required).

canvas_get_submissionB

Get submission details for an assignment

Inputs: assignment_id (required), course_id (required), user_id.

canvas_get_syllabusC

Get course syllabus

Inputs: course_id (required).

canvas_get_upcoming_assignmentsC

Get upcoming assignment due dates

Inputs: limit.

canvas_get_user_gradesB

Get all grades for the current user

Inputs: no named parameters.

canvas_get_user_profileB

Get current user's profile

Inputs: no named parameters.

canvas_health_checkB

Check the health and connectivity of the Canvas API

Inputs: no named parameters.

canvas_list_account_coursesC

List courses for an account

Inputs: account_id (required), completed, order, published, +3 more.

canvas_list_account_usersC

List users for an account

Inputs: account_id (required), order, search_term, sort.

canvas_list_announcementsC

List all announcements in a course

Inputs: course_id (required).

canvas_list_assignment_groupsC

List assignment groups for a course

Inputs: course_id (required).

canvas_list_assignmentsC

List assignments for a course

Inputs: course_id (required), include_submissions.

canvas_list_calendar_eventsC

List calendar events

Inputs: end_date, start_date.

canvas_list_conversationsB

List user's conversations

Inputs: no named parameters.

canvas_list_coursesC

List all courses for the current user

Inputs: include_ended.

canvas_list_discussion_topicsC

List all discussion topics in a course

Inputs: course_id (required).

canvas_list_filesC

List files in a course or folder

Inputs: course_id (required), folder_id.

canvas_list_foldersC

List folders in a course

Inputs: course_id (required).

canvas_list_module_itemsC

List all items in a module

Inputs: course_id (required), module_id (required).

canvas_list_modulesC

List all modules in a course

Inputs: course_id (required).

canvas_list_notificationsB

List user's notifications

Inputs: no named parameters.

canvas_list_pagesC

List pages in a course

Inputs: course_id (required).

canvas_list_quizzesC

List all quizzes in a course

Inputs: course_id (required).

canvas_list_rubricsC

List rubrics for a course

Inputs: course_id (required).

canvas_list_sub_accountsC

List sub-accounts for an account

Inputs: account_id (required).

canvas_mark_module_item_completeC

Mark a module item as complete

Inputs: course_id (required), item_id (required), module_id (required).

canvas_post_to_discussionC

Post a message to a discussion topic

Inputs: course_id (required), message (required), topic_id (required).

canvas_start_quiz_attemptC

Start a new quiz attempt

Inputs: course_id (required), quiz_id (required).

canvas_submit_assignmentC

Submit work for an assignment

Inputs: assignment_id (required), course_id (required), submission_type (required), body, +2 more.

canvas_submit_gradeB

Submit a grade for a student's assignment (teacher only)

Inputs: assignment_id (required), course_id (required), grade (required), user_id (required), +1 more.

canvas_update_assignmentC

Update an existing assignment

Inputs: assignment_id (required), course_id (required), description, due_at, +3 more.

canvas_update_courseC

Update an existing course in Canvas

Inputs: course_id (required), allow_student_forum_attachments, allow_student_wiki_edits, allow_wiki_comments, +17 more.

canvas_update_user_profileC

Update current user's profile

Inputs: bio, name, short_name, time_zone, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 54 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific Canvas resources and actions, with clear naming like 'canvas_get_assignment' vs 'canvas_list_assignments'. However, some tools like 'canvas_get_dashboard' and 'canvas_get_dashboard_cards' could potentially overlap in functionality, and there are multiple 'get' tools that might be confused if the agent doesn't carefully read descriptions.

    Naming Consistency5/5

    All tools follow a perfect 'canvas_verb_noun' pattern consistently throughout the entire set. The naming convention is uniform with snake_case, clear verbs (create, get, list, update, etc.), and specific nouns, making it highly predictable and readable.

    Tool Count2/5

    With 54 tools, this is an extremely large set that feels heavy and overwhelming for a typical MCP server. While Canvas is a complex platform, this many tools suggests poor scoping and could lead to confusion or inefficiency in agent usage, as it's well beyond the typical 3-15 tool range for well-scoped servers.

    Completeness5/5

    The tool set provides comprehensive coverage of the Canvas LMS domain, including CRUD operations for accounts, courses, assignments, quizzes, users, and more, plus specialized actions like enrollment, grading, and module completion. There are no obvious gaps—it supports full lifecycle management and common workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers