canvas-lms-mcp-local

ヒント

スマートフォンやウェブ、複数のコンピューターで使いたいですか？ **🌐 リモート版 →**をご覧ください。209 個のツールはそのままに、パスワードで保護された ngrok トンネル経由で提供され、コンピューター間の自動フェイルオーバーにも対応しています。

🤔 ローカル版とリモート版のどちらを選びますか？

✨ 特長

• 📊 成績分析：what_if_grade、compute_needed_score、grade_impact_ranking、加重方式による詳細な内訳
• 📅 計画：get_week_ahead、semester_snapshot、study_priority_ranking、複数コースの未提出課題を 1 回の呼び出しで確認
• 📝 提出：テキスト、URL、ファイルを提出。最初にドライランでプレビューできます
• 💬 ディスカッションと受信トレイ：リクエスト 1 回でスレッド全体を読み、教員にメッセージを送信
• 📁 コンテンツ：ファイル、ページ、モジュール、講義の字幕、コース全体の .imscc エクスポート

🧭 仕組み

 Your AI app (MCP client)      ──stdio──►  node index.js  ──HTTPS──►  your school's Canvas API
        (starts the server)              (209 tools, runs only
                                          while your app is open)

ウェブサーバーもポートもなく、稼働し続けるサービスも不要です。AI アプリを開くとサーバーが起動し、アプリを閉じると停止します。

🚀 クイックスタート

必要なもの： Node.js 18+ と Canvas アカウント。自分でダウンロードするものはありません。AI アプリが npx でサーバーを取得します。

1. Canvas アクセストークンを作成する

Canvas で Account → Settings → Approved Integrations → + New Access Token の順に移動します。Canvas でトークンが表示されるのは一度だけなので、すぐにコピーしてください。学生用トークンの有効期限は通常 30～120 日です。

2. AI アプリに追加する

npx -y canvas-lms-mcp-local

3. 試してみる

アシスタントに 「Run test_connection.」 と尋ねます。ユーザー情報、コース、プランナー、受信トレイ、未提出の課題を確認し、学校で無効になっている機能があれば報告します。

次に、「今週の締め切りは？」、「最終試験で B を取るには何点必要？」、または 「成績に最も影響している未提出課題はどれ？」 と尋ねてみましょう。

git clone https://github.com/Fireiscoolsolo/canvas-lms-mcp-local.git
cd canvas-lms-mcp-local
npm install

{ "mcpServers": { "canvas": { "command": "node", "args": ["C:/Users/YOUR-NAME/Documents/canvas-lms-mcp-local/index.js"] } } }

⚙️ 設定

ステップ 2 のように、設定の env ブロックに設定値を記述します。ソースから実行する場合は、代わりに index.js と同じ場所にある .env を使用できます。

🧰 ツール

🔐 セキュリティ

• 外部には公開されません： サーバーはどのポートでも待ち受けません。起動したアプリだけが、プライベートなパイプを通じてサーバーと通信できます。
• 確認ゲート： 送信、提出、投稿、削除を行うツールは、まずプレビューを返し、confirm: true を指定して呼び出された場合にのみ処理を実行します。
• プロンプトインジェクション対策： 他の人が書いたテキストは <<<CANVAS_CONTENT>>> マーカーで囲み、信頼できないテキストとしてラベル付けします。
• 小テストの受験はできません： 小テストの受験エンドポイントは意図的に含めていません。

.env は絶対にコミットしないでください。 すでに .gitignore に記載されています。SECURITY.md を参照してください。

🎓 責任ある利用

これは学習と整理のためのツールです。締め切りの確認、成績の把握、週の計画に役立ちます。クイズに回答することはなく、プレビューを確認して承認するまでは、何も送信・提出されません。

• 学校の学業上の誠実さおよび利用規定を守ってください。学校によっては、個人用 API トークンやサードパーティ製ツールの使用が制限されています。
• 誤操作による変更のリスクをゼロにしたい場合は、読み取り専用モードにするため CANVAS_ALLOW_WRITES=false を設定してください。

🛠️ トラブルシューティング

既知の制限： 学生用トークンでは、管理者向けエンドポイント、成績表の履歴、コース分析、クイズの統計情報にはアクセスできません。smart_search は Canvas のベータ機能であり、404 を返すことがよくあります。

📄 ライセンス

MIT。このプロジェクトは Instructure とは提携していません。