# Graph Indexer: servidor MCP de grafo de código para agentes de IA

> Graph Indexer es un grafo de código y buscador local, gratuito y con licencia MIT, para agentes de IA por MCP: referencias exactas, llamadas, impacto de cambios y comprobación de ediciones.

Graph Indexer es un grafo de código y buscador en vivo para agentes de IA que programan, servido en local por MCP. Da a los agentes referencias exactas, grafos de llamadas, impacto de cambios y comprobación de ediciones, sin modelo, sin red y sin compilaciones nativas. Es gratuito, de código abierto (MIT) y necesita Node.js 22.5 o superior.

Instálalo en tu repositorio con un solo comando:

```bash
npx graph-indexer init
```

## ¿Qué hace Graph Indexer?

Graph Indexer analiza tu repositorio con tree-sitter y mantiene un índice estructural: cada definición, cada referencia enlazada con la definición a la que apunta de verdad, el grafo de llamadas, la herencia, los imports y qué tests ejercitan qué. Los agentes lo consultan con ocho herramientas MCP de solo lectura en vez de leer archivos enteros y hacer grep. Mira [Cómo funciona Graph Indexer](/es/how-it-works/).

## ¿Por qué es mejor que grep?

Graph Indexer lista los llamadores del método que quieres, no los de todos los métodos con el mismo nombre. Con 400 símbolos de nestjs contrastados con el compilador de TypeScript:

| Método | Precisión | Recall |
|---|---|---|
| `find_references` de Graph Indexer | 99,7 % | 96,2 % |
| grep del nombre | 12,8 % | 99,3 % |

En Go (contrastado con el type checker de Go) alcanza entre el 99,2 % y el 100 % de precisión, y en Java (contrastado con el compilador de Java) entre el 95,5 % y el 99,4 %. En sesiones reales de Claude Code con 12 preguntas sobre código, el agente acertó las 12 con Graph Indexer frente a 9 de 12 sin él. En 24 preguntas sobre código de dos repositorios, costó un 16 % menos que sin índice. Arreglar incidencias reales no mostró un ahorro medible. Detalles: [benchmarks](/es/benchmarks/) y [Graph Indexer vs grep](/es/graph-indexer-vs-grep/).

## ¿Cuáles son las ocho herramientas?

| Herramienta | Úsala para |
|---|---|
| `read_code` | leer símbolos, rangos de líneas o archivos, con dónde se define cada nombre que usan |
| `search_text` | hacer grep de cualquier texto, con la definición que envuelve cada coincidencia |
| `search_code` | encontrar dónde vive un comportamiento o un identificador |
| `find_references` | ver todos los usos antes de renombrar o cambiar una firma |
| `call_graph` | rastrear llamadores y llamados entre archivos |
| `change_impact` | obtener el radio de impacto de un cambio y los tests a ejecutar |
| `check_changes` | verificar ediciones sin confirmar y sin compilar |
| `outline` | ver la estructura de un archivo o un mapa ordenado del repositorio |

Todas son de solo lectura y suelen responder con unos 400 a 1.500 tokens. Referencia completa: [herramientas](/es/tools/).

## ¿Qué agentes y lenguajes soporta?

El comando `init` configura Claude Code, Cursor, VS Code Copilot, Codex, Gemini CLI, OpenCode, Kilo Code, Junie, Zed y Devin. Guías: [todos los agentes](/es/agents/), [Claude Code](/es/agents/claude-code/), [Cursor](/es/agents/cursor/), [VS Code Copilot](/es/agents/vscode-copilot/), [Codex](/es/agents/codex/), [Gemini CLI](/es/agents/gemini-cli/), [OpenCode](/es/agents/opencode/), [Kilo Code](/es/agents/kilo-code/), [Junie](/es/agents/junie/), [Zed](/es/agents/zed/) y [Devin](/es/agents/devin/).

Dieciséis gramáticas tree-sitter vienen como WebAssembly: JavaScript, TypeScript, TSX, Python, Go, Java, Kotlin, Scala, C#, Rust, C, C++, Ruby, PHP, Bash y CSS. El enlace es más profundo en TypeScript, JavaScript, Python, Go, Java, C# y Rust. Mira [lenguajes](/es/languages/).

## ¿Cómo instalo el plugin de Claude Code?

```text
/plugin marketplace add MaquinaTech/graph-indexer
/plugin install graph-indexer@graph-indexer
```

El plugin incluye el servidor MCP, tres hooks y un subagente de solo lectura, `code-structure`. Mira [la página del plugin](/es/claude-code-plugin/) y la [guía de instalación](/es/install/).

## ¿Es privado?

El propio Graph Indexer no hace llamadas de red ni envía telemetría. Funciona en local, habla con el agente solo por stdio y nunca lee fuera del repositorio. El agente sigue enviando lo que lee a su proveedor de modelo. El índice vive en `.graph-indexer/` y está ignorado por git.

## ¿Qué velocidad tiene?

Indexar entero nestjs (1.641 archivos, 96.000 líneas) tarda 3,7 segundos, y después solo se vuelven a analizar los archivos cambiados. Las llamadas en caliente a las herramientas de grafo tardan de 1 a 4 ms.

## ¿Cuáles son los límites?

Graph Indexer no es un type checker. Los genéricos, la reflexión, `any` y la inyección de dependencias por token de texto solo se ven en parte, y Java fue el lenguaje más débil de los medidos. Los benchmarks con agentes usan muestras pequeñas.

## ¿Dónde puedo saber más?

- [Instalar](/es/install/), [Plugin de Claude Code](/es/claude-code-plugin/), [Herramientas](/es/tools/), [Cómo funciona](/es/how-it-works/), [Lenguajes](/es/languages/), [FAQ](/es/faq/)
- [Benchmarks](/es/benchmarks/), [Graph Indexer vs grep](/es/graph-indexer-vs-grep/)
- Código y documentación: https://github.com/MaquinaTech/graph-indexer
- npm: https://www.npmjs.com/package/graph-indexer

---

Actualizado: 2026-09-23 · Graph Indexer 3.0.0 · https://graph-indexer.vercel.app/es/