Agentes

Graph Indexer para VS Code Copilot

Añade Graph Indexer al modo agente de Copilot en VS Code con npx graph-indexer init, que escribe .vscode/mcp.json con la clave servers para referencias.

Actualizado Graph Indexer 3.0.0 Ver en Markdown

Graph Indexer para VS Code Copilot es un servidor MCP local que permite al modo agente de Copilot llamar a herramientas exactas de referencias, grafo de llamadas e impacto de cambios sobre tu espacio de trabajo. Ejecuta npx graph-indexer init; escribe .vscode/mcp.json en el formato propio de VS Code, que usa servers y "type": "stdio".

¿Cómo añado Graph Indexer a VS Code Copilot?

Desde la raíz del repositorio, con Node.js 22.5 o superior:

npx graph-indexer init

init elige VS Code cuando el repositorio contiene un directorio .vscode. Para elegirlo explícitamente, ejecuta npx graph-indexer init --agents vscode.

¿Qué escribe npx graph-indexer init para VS Code?

Para VS Code Copilot, init escribe:

ArchivoContenido
.vscode/mcp.jsonUna entrada graph-indexer bajo servers, fusionada con los servidores que ya haya
AGENTS.mdUn bloque gestionado con las reglas de búsqueda
.gitignore.graph-indexer/

¿Cómo es la configuración MCP de VS Code?

VS Code se diferencia de la mayoría de agentes en dos cosas: la clave de primer nivel es servers y cada servidor declara "type": "stdio". La entrada que escribe init es:

{
  "servers": {
    "graph-indexer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "graph-indexer@3", "serve", "--repo", "${workspaceFolder}"]
    }
  }
}

La variable ${workspaceFolder} hace el archivo portable entre máquinas.

¿Añade Graph Indexer hooks para VS Code?

El comando de hooks de Graph Indexer lee el formato de payload de Claude Code, que según el código fuente comparten VS Code, Codex, Copilot CLI y Devin. Pero init --hooks solo escribe hooks en .claude/settings.json para Claude Code y Devin; no genera ningún archivo de hooks específico de VS Code. Con VS Code Copilot, apóyate en las herramientas MCP, que funcionan sin hooks.

¿Qué gana VS Code Copilot con Graph Indexer?

En modo agente, Copilot puede llamar a ocho herramientas de solo lectura. Las respuestas típicas ocupan entre 400 y 1.500 tokens: la función correcta con números de línea en lugar de un archivo de 2.000 líneas.

  • find_references separa los llamadores reales de UserService.find de cualquier otro método llamado find e indica si la lista está completa.
  • change_impact lista los dependientes por distancia y los tests que ejecutar.
  • search_code encuentra dónde vive un comportamiento a partir de una consulta en lenguaje natural.
  • read_code lee varios símbolos o rangos de líneas en una llamada, con la definición de cada nombre que usan.

El índice se resincroniza con los archivos en disco antes de cada respuesta, así que incluye las ediciones que Copilot hizo hace un momento. La precisión de las referencias se mide contra compiladores y comprobadores de tipos; mira los benchmarks y la referencia de herramientas.

Preguntas frecuentes

¿Por qué el archivo de VS Code usa servers y no mcpServers?

El formato MCP de VS Code usa la clave servers y un type stdio explícito, a diferencia de la mayoría de agentes, que usan mcpServers. init escribe la forma de VS Code, así no tienes que traducirla.

¿Funciona en el chat de Copilot o solo en modo agente?

Las herramientas MCP las llama el modo agente de Copilot, donde el modelo elige las herramientas. Graph Indexer es un proveedor de herramientas, así que necesita un modo de Copilot capaz de llamar a MCP.

¿Es seguro commitear .vscode/mcp.json?

La entrada solo contiene un comando y ${workspaceFolder}, sin secretos ni rutas absolutas salvo que uses --local. Commitearla da el servidor a todo el equipo; el directorio del índice .graph-indexer va al gitignore.

¿Y si mi .vscode/mcp.json tiene comentarios?

init no reescribe archivos con comentarios o que no son JSON plano, porque un ciclo de JSON los perdería. Deja el archivo como está e imprime la entrada exacta para añadirla a mano.

Pruébalo en tu repo.

npx graph-indexer init
¿Usas Claude Code? Instala el plugin