canonical-vault-mcp-server

只读 MCP 服务器，将 canonical-vault GitHub 仓库暴露给任何 MCP 客户端 —— GitHub Copilot、Claude，或任何支持 Streamable HTTP MCP 的客户端。

五个工具，全部只读，全部限定于 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 控制台 → 设置 → 环境变量中设置）

添加环境变量后，重新部署（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 → 启动。Copilot Chat 会自动识别这五个 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 接入之前，针对实时仓库手动调用每个工具。

要在本地测试 HTTP 路径而不是 stdio：

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

设计选择说明

• 无状态按请求传输：api/mcp.ts 在每次 POST 时都会创建一个全新的 McpServer + StreamableHTTPServerTransport。这是无服务器架构的正确模式 —— Vercel 函数在调用之间不会保留内存，因此无需维护会话，而且可以避免两个调用者同时访问端点时发生请求 ID 冲突。

• 谱系 = 提交历史，而非自定义概念 —— vault_get_file_history 实际上就是 GET /commits?path=...，这是将"谱系"映射到 GitHub API 实际提供能力的最忠实方式。如果你的 vault 谱系链概念（治理/vault 流水线）需要更具体的内容 —— 例如读取位于仓库内的谱系清单文件 —— 那么更好的做法是让 vault_get_file 直接指向该清单，而不是由我们重新实现 git 历史。

• 按你的要求设计为只读 —— 此服务器无法写入 canonical-vault。如果你之后希望 Copilot 提交回写（例如通过 PR），那需要单独一套带有真正破坏性操作审查的写入工具，而不是悄悄附加的功能。

• 搜索注意事项：GitHub 的代码搜索 API 只索引默认分支，并且有自身的传播延迟 —— 几秒前刚提交的文件可能还不会出现在 vault_search_files 中。vault_get_file 和 vault_list_directory 始终反映实时文件树。