Campus Copilot MCP

@campus-copilot/mcp-server

ローカルの CampusCopilot BFF とインポート済みのワークスペーススナップショットを対象とする、読み取り専用の MCP サーバーです。

examples/integrations/ にある統合例で使用されている、汎用 MCP エントリーポイントです。

Codex / Claude Code のようなローカル MCP ワークフローで、最小構成の単一サーバーエントリーポイントが必要な場合は、このパッケージを使用してください。

汎用 MCP サーバー、サイトのサイドカー、CLI、SDK のどれを使うかまだ決めていない場合は、まず ../../examples/toolbox-chooser.md をご覧ください。

インストール

現在のインストール状況：リポジトリ内の公開サーフェスで、JS サーバーの成果物をバンドルしています。公式 MCP Registry の経路では、このサーバー用に GitHub のリリースから配布する .mcpb バンドルを使用するようになりました。検出ページでの表示を再確認する作業は、引き続き別途必要です。

リポジトリのルートから実行します：

pnpm install
pnpm --filter @campus-copilot/mcp-server build
pnpm start:mcp

リポジトリのルートから実行する、共通の公開プレビュー検証手順：

pnpm proof:public

まず試すコマンド：

pnpm --filter @campus-copilot/mcp-server start

このリポジトリでの Registry 対応の進捗：

• 公開された bin は、生の TypeScript エントリーポイントではなく、バンドル済みの dist/bin.mjs 成果物を対象とするようになりました
• Registry の経路では、存在しない公開 npm スコープに依存する代わりに、リリースから配布する .mcpb バンドルを使用するようになりました
• preregistry メタデータは、パッケージと同じ場所にある server.json と、パッケージレベルの mcpName に置かれています
• バンドルのマニフェストは mcpb.manifest.json に置かれています
• リポジトリ側の提出準備済みフィールドは、registry-submission.packet.json にも置かれています
• 公開配布のルーターは ../../DISTRIBUTION.md にあります
• Registry の検出ページでの表示を再確認する作業は、引き続き別途必要です。この README は、掲載 UI がすでに再確認済みであることを示すものではありません

リポジトリのルートから実行する Registry 事前チェック：

pnpm check:mcp-registry-preflight

この事前チェックでは、後工程でずれが生じやすい、以下の整合性を確認します：

• package.json#mcpName
• server.json のリリースアセット URL／SHA／トランスポートの整合性
• mcpb.manifest.json のバージョンとエントリーポイントの整合性
• モノレポの subfolder パス
• サンプル設定と、実態に即したインストール方法の説明
• 後で所有者が再利用できる、リポジトリ管理の提出パケット

関連する公開配布ドキュメント：

• ../../DISTRIBUTION.md

コンテナの経路と併用する

現在の Docker サーフェスは意図的に薄いローカル BFFとしており、この stdio サーバー自体ではありません。

この分割には理由があります：

• stdio MCP サーバーは、ローカルの読み取り専用 MCP エントリーポイントとして機能します
• Docker の経路により、リポジトリに実態に即した HTTP サーフェスとヘルスチェック用サーフェスを提供します
• これらを併用することで、CampusCopilot がホスト型 MCP サービスであるかのように見せることなく、ローカルファーストを維持できます

リポジトリのルートから、コンテナ化された BFF をビルドします：

docker build -t campus-copilot-api:local .
docker compose up -d campus-copilot-api

ローカル HTTP サーフェスやコンテナ向けのヘルスチェックが必要な場合は、コンテナの経路を使用してください。 ローカル stdio MCP サーバーが必要な場合は、このパッケージを引き続き使用してください。 一文で簡潔に言うと、ローカル stdio MCP サーバーと併用し、Docker の経路はホスト型 API ではなく、ローカル HTTP 用のヘルパーとして扱ってください。

Compose を使わずに、ローカルコンテナを直接起動することもできます：

docker run --rm -p 8787:8787 campus-copilot-api:local

現在のツール

• campus_health
• providers_status
• ask_campus-copilot
• canvas_snapshot_view
• gradescope_snapshot_view
• edstem_snapshot_view
• myuw_snapshot_view
• export_snapshot_artifact

境界

• ローカルファースト
• 読み取り専用
• stdio
• スナップショット優先または薄い BFF 優先
• ホスト型 MCP サービスではありません
• ホスト型 API ではありません
• ライブブラウザーの制御プレーンではありません
• キャンパスサイトを変更するサーフェスではありません
• 履修登録を自動化するサーフェスではありません
• コースの生ファイルを AI にアップロードするサーフェスではありません

ここでも、他と同じ学術利用の安全性に関する取り決めを適用してください：

• ../../docs/07-security-privacy-compliance.md

See also

• ../../examples/toolbox-chooser.md
• ../../examples/integrations/README.md
• ../../examples/integrations/codex-mcp.example.json
• ../../examples/integrations/codex-mcp-shell.example.json
• ../../examples/integrations/claude-code-mcp.example.json
• ../../examples/integrations/claude-code-mcp-shell.example.json
• ../../examples/openclaw-readonly.md