canonical-vault-mcp-server

canonical-vault GitHub リポジトリをあらゆる MCP クライアント（GitHub Copilot、Claude、その他 Streamable HTTP MCP に対応するもの）に公開する読み取り専用 MCP サーバー。

5 つのツールはすべて読み取り専用で、すべて kushkillerjsixx66/canonical-vault にスコープされています:

このサーバーには意図的に書き込みツールは存在しません。ここから vault にコミット、プッシュ、変更を行うことはできません。

1. Vercel へのデプロイ

npm install -g vercel   # if you don't have it
cd canonical-vault-mcp-server
vercel login
vercel

デフォルトを受け入れてください（Vercel は api/mcp.ts を Node サーバーレス関数として自動検出します）。vercel --prod の後、次のような URL が得られます:

https://canonical-vault-mcp-server.vercel.app

MCP エンドポイントは次のとおりです:

https://canonical-vault-mcp-server.vercel.app/api/mcp

環境変数（Vercel ダッシュボード → Settings → Environment Variables で設定）

環境変数を追加したら、関数がそれを取得できるように再デプロイ（vercel --prod）してください。

Related MCP server: github-mcp-tool

2. GitHub Copilot を接続する

Copilot（VS Code 内、および Copilot コーディングエージェント）は、ワークスペース内の .vscode/mcp.json または VS Code のグローバル MCP 設定から MCP サーバー設定を読み取ります。追加:

{
  "servers": {
    "canonical-vault": {
      "type": "http",
      "url": "https://canonical-vault-mcp-server.vercel.app/api/mcp"
    }
  }
}

次に VS Code で: コマンドパレット → "MCP: List Servers" → canonical-vault → Start。Copilot Chat は 5 つの vault_* ツールを自動的に認識し、エージェントモードで呼び出すことができます。

Copilot のリモートコーディングエージェント（VS Code ローカルではない）の場合、同じ URL を github.com の組織の MCP サーバー設定に登録できます。Copilot のエージェント MCP 設定がプランに応じて存在する場所です。その部分は GitHub 側の責任であり、このサーバーの責任ではありません。

3. ローカルテスト（デプロイ前）

npm install
npm run build
npx @modelcontextprotocol/inspector node dist/index.js

これにより MCP Inspector UI が開き、Copilot を接続する前にライブリポジトリに対して各ツールを手動で呼び出すことができます。

stdio の代わりにローカルで HTTP パスをテストするには:

npm install -g vercel
vercel dev
# endpoint: http://localhost:3000/api/mcp

設計上の選択に関するメモ

• ステートレスなリクエストごとのトランスポート: api/mcp.ts は POST のたびに新しい McpServer + StreamableHTTPServerTransport を作成します。これはサーバーレスに適したパターンです。Vercel 関数は呼び出し間でメモリを保持しないため、維持するセッションはなく、2 つの呼び出し元が同時にエンドポイントにヒットした場合のリクエスト ID の衝突も回避できます。

• 系統 = コミット履歴。特別な概念ではありません。vault_get_file_history は文字通り GET /commits?path=... であり、「系統」を GitHub の API が実際に提供するものに最も正直にマッピングしたものです。vault の系統チェーン概念（ガバナンス/vault パイプライン）がより具体的なものを必要とする場合（例: リポジトリ内にある系統マニフェストファイルの読み取り）、git 履歴を再実装するよりも、vault_get_file をそのマニフェストに直接向ける方が適しています。

• 設計上読み取り専用（ご回答に基づく）: このサーバーは canonical-vault に書き込むことはできません。後で Copilot にコミットバックさせたい場合（例: PR 経由）は、実際の破壊的操作のレビューを伴う別の書き込みツールセットであり、静かに追加するものではありません。

• 検索の注意点: GitHub のコード検索 API はデフォルトブランチのみをインデックスし、独自の伝播遅延があります。数秒前にコミットされたファイルは vault_search_files にまだ表示されない可能性があります。vault_get_file と vault_list_directory は常にライブツリーを反映します。