Esta página responde a las preguntas que más se hacen los desarrolladores sobre Graph Indexer, un grafo de código y buscador local al que los agentes de IA llaman por MCP. Cada respuesta se entiende por sí sola y enlaza a la página con el detalle completo.
Para empezar, mira Instalar Graph Indexer; para la mecánica, Cómo funciona Graph Indexer; y para las mediciones, los benchmarks y la comparativa Graph Indexer vs grep. Las ocho herramientas están en la página de herramientas y los lenguajes soportados en la página de lenguajes.
Preguntas frecuentes
¿Qué es Graph Indexer?
Graph Indexer es un grafo de código y buscador gratuito, con licencia MIT, para agentes de IA que programan, servido en local por MCP. Analiza tu repositorio con tree-sitter y responde con exactitud sobre referencias, llamadores, impacto de cambios y ediciones, en respuestas pequeñas.
¿Qué es MCP y por qué lo usa Graph Indexer?
MCP, el Model Context Protocol, es el estándar abierto con el que los agentes de IA llaman a herramientas externas. Graph Indexer funciona como servidor MCP por stdio, así que cualquier agente compatible puede llamar a sus ocho herramientas de solo lectura sin un plugin propio.
¿En qué se diferencia Graph Indexer de grep?
Grep compara texto; Graph Indexer enlaza cada referencia con la definición a la que apunta. Con 400 símbolos de nestjs contrastados con el compilador de TypeScript, find_references logró un 99,7 % de precisión y un 96,2 % de recall, y grep del nombre un 12,8 % de precisión.
¿Graph Indexer usa embeddings o un modelo de lenguaje?
No. La búsqueda es léxica más grafo: BM25 sobre nombres, firmas, documentación y cuerpos, un pequeño tesauro de conceptos y centralidad PageRank. No necesita modelo, embeddings, descargas ni red.
¿Qué lenguajes de programación soporta Graph Indexer?
Dieciséis gramáticas tree-sitter incluidas: 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. Los detalles están en la página de lenguajes.
¿Graph Indexer envía mi código a algún sitio?
El propio Graph Indexer no hace llamadas de red ni envía telemetría; habla con el agente solo por stdio y nunca lee fuera del repositorio. El agente sigue enviando lo que lee, incluidas las respuestas de Graph Indexer, a su proveedor de modelo.
¿Graph Indexer es gratis? ¿Cuánto cuesta?
Graph Indexer es gratuito y de código abierto con licencia MIT, sin cuenta ni clave de API. El único coste es el uso de modelo de tu agente, que tiende a bajar: en sesiones reales de Claude Code, las preguntas sobre código cuestan un 16 % menos.
¿Qué velocidad tiene Graph Indexer?
Indexar entero nestjs, con 1.641 archivos y 96.000 líneas, tarda 3,7 segundos. 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, la búsqueda unos 30 ms y los hooks o la CLI responden en unos 0,1 segundos.
¿Graph Indexer funciona en monorepos grandes?
Sí. Indexó el monorepo del CRM Twenty, con 28.512 archivos y unos 2,3 millones de líneas, en 51 segundos, y lo resincronizó sin cambios en 1,8 segundos. Contra el compilador de TypeScript, en su paquete de servidor, la precisión fue del 99,9 % y el recall del 92,4 %.
¿Dónde se guarda el índice y debo subirlo al repositorio?
El índice es un archivo SQLite en .graph-indexer/index.db dentro de tu repositorio. El comando init añade la carpeta a .gitignore. No lo subas ni lo compartas: contiene fragmentos de tu código, así que trátalo como el propio repositorio. Borrarlo es seguro.
¿Puede el índice quedarse desactualizado?
No en el momento de responder. Graph Indexer se resincroniza con los archivos del disco antes de cada llamada a una herramienta, con un vigilante de archivos y barridos periódicos, y revalida los archivos justo antes de citar sus líneas, así que incluye ediciones de hace un segundo.
¿Cómo instalo el plugin de Graph Indexer para Claude Code?
Ejecuta /plugin marketplace add MaquinaTech/graph-indexer y después /plugin install graph-indexer@graph-indexer. El plugin incluye el servidor MCP, tres hooks y un subagente de solo lectura, code-structure. También puedes ejecutar npx graph-indexer init en el repositorio.
¿Con qué agentes de IA para programar funciona Graph Indexer?
El comando init configura Claude Code, Cursor, VS Code Copilot, Codex, Gemini CLI, OpenCode, Kilo Code, Junie, Zed y Devin. Cualquier otro cliente que pueda ejecutar un servidor MCP por stdio puede usarlo con una configuración manual.
¿Qué versión de Node.js necesita Graph Indexer?
Node.js 22.5 o superior, porque el índice usa el módulo integrado node:sqlite. No hay dependencias npm, ni compilaciones nativas, ni nada que compilar. Instala y conecta tus agentes con npx graph-indexer init.
¿Cuáles son los límites de 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. Arreglar incidencias reales no mostró un ahorro medible, y los benchmarks con agentes usan muestras pequeñas.