canonical-vault-mcp-server

Servidor MCP de solo lectura que expone el repositorio de GitHub canonical-vault a cualquier cliente MCP — GitHub Copilot, Claude o cualquier otra cosa que hable Streamable HTTP MCP.

Cinco herramientas, todas de solo lectura, todas limitadas a kushkillerjsixx66/canonical-vault:

No existen herramientas de escritura en este servidor a propósito: nada aquí puede hacer commit, push o modificar el vault.

1. Desplegar en Vercel

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

Acepta los valores predeterminados (Vercel detecta automáticamente api/mcp.ts como una función serverless de Node). Después de vercel --prod, obtendrás una URL como:

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

Tu endpoint de MCP es:

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

Variables de entorno (configúralas en el panel de Vercel → Settings → Environment Variables)

Después de añadir las variables de entorno, vuelve a desplegar (vercel --prod) para que la función las recoja.

Related MCP server: github-mcp-tool

2. Conectar GitHub Copilot a él

Copilot (en VS Code y el agente de codificación de Copilot) lee la configuración del servidor MCP desde .vscode/mcp.json en tu espacio de trabajo, o desde la configuración global de MCP de VS Code. Añade:

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

Luego, en VS Code: Paleta de comandos → "MCP: List Servers" → canonical-vault → Iniciar. Copilot Chat detectará automáticamente las cinco herramientas vault_* y podrá invocarlas en modo agente.

Para el agente de codificación remoto de Copilot (no el local de VS Code), la misma URL se puede registrar en la configuración del servidor MCP de tu organización en github.com, dondequiera que se encuentre la configuración MCP del agente de Copilot para tu plan; esa parte está del lado de GitHub, no de este servidor.

3. Pruebas locales (antes de desplegar)

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

Esto abre la interfaz de MCP Inspector, donde puedes llamar a cada herramienta manualmente contra el repositorio en vivo antes de conectar Copilot a él.

Para probar la ruta HTTP localmente en lugar de stdio:

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

Notas sobre las decisiones de diseño

• Transporte sin estado por solicitud: api/mcp.ts crea un McpServer + StreamableHTTPServerTransport nuevos en cada POST. Este es el patrón correcto para serverless: las funciones de Vercel no conservan memoria entre invocaciones, por lo que no hay sesión que mantener, y evita colisiones de ID de solicitud si dos llamadores acceden al endpoint a la vez.

• Linaje = historial de commits, no un concepto a medida: vault_get_file_history es literalmente GET /commits?path=..., que es la correspondencia honesta más cercana de "linaje" con lo que la API de GitHub realmente ofrece. Si el concepto de cadena de linaje de tu vault (pipeline de gobernanza/vault) necesita algo más específico — p. ej., leer un archivo manifiesto de linaje que vive en el repositorio —, eso se sirve mejor apuntando vault_get_file directamente a ese manifiesto en lugar de que nosotros reimplementemos el historial de git.

• Solo lectura por diseño, según tu respuesta: este servidor no puede escribir en canonical-vault. Si más adelante quieres que Copilot haga commit de vuelta (p. ej. mediante un PR), eso es un conjunto separado de herramientas de escritura con una revisión real de acciones destructivas, no algo que acoplar silenciosamente.

• Advertencia sobre la búsqueda: la API de búsqueda de código de GitHub solo indexa la rama predeterminada y tiene su propio retraso de propagación: un archivo commiteado hace segundos puede no aparecer todavía en vault_search_files. vault_get_file y vault_list_directory siempre reflejan el árbol en vivo.