graphify-ts: El servidor MCP local reduce los tokens de revisión de PR de Claude Code de 63K a 8.7K

Si has usado Claude Code en un código fuente real, has visto el problema: cada pregunta desencadena 8-10 llamadas secuenciales a herramientas (glob, grep, read, read, read) para construir contexto desde cero. Los tokens de entrada se acumulan, la latencia se arrastra y el agente redescubre la misma estructura cada vez. graphify-ts es un servidor MCP gratuito y de código abierto que pre-indexa tu código en un grafo de conocimiento local, para que Claude haga una única llamada retrieve.

Cómo funciona

En el momento de la indexación, graphify-ts analiza tu código con tree-sitter AST, extrae relaciones estructurales (archivos, funciones, clases, llamadas, importaciones), ejecuta la detección de comunidades Louvain para agrupar módulos relacionados, indexa con BM25 y, opcionalmente, re-ordena con un modelo ONNX local. El grafo resultante se sirve a través de MCP stdio — completamente local, ningún dato sale de tu portátil. El perfil principal predeterminado expone 6 herramientas para mantener baja la sobrecarga de la sesión (aproximadamente 5K tokens); puedes optar por la superficie completa de 21 herramientas con GRAPHIFY_TOOL_PROFILE=full.

Puntos de referencia verificables

El repositorio incluye un script verify.sh que re-deriva todos los números a partir de evidencia confirmada. Los resultados se midieron en un código fuente real de producción NestJS + Next.js (1,268 archivos) con Claude Opus 4.7:

• Consulta de código única: 9 llamadas a herramientas → 615,190 tokens de entrada → 233,508 (2.6× menos), latencia 96 seg → 35 seg (2.8× más rápida). Ambos del campo de uso --output-format json de Claude.
• Revisión de PR de 36 archivos: Los tokens de prompt se redujeron de 63,024 a 8,690 (7.25× más pequeños). Mismo revisor, mismo diff, misma profundidad de revisión — ambas ejecuciones marcaron los mismos puntos críticos.
• Pregunta multi-repositorio en 3 repos: Prompt naive estimado ~1.5M tokens (no cabría en ninguna ventana) frente a 2,800 tokens con graphify-ts. El autor señala que esto es una estimación estructural, no un prompt enviado.

Instalación y uso

npm install -g @mohammednagy/graphify-ts
cd tu-proyecto
graphify-ts generate .
graphify-ts claude install

También funciona con Cursor, Copilot, Gemini CLI, Aider, OpenCode mediante <agent> install.

Compensaciones a tener en cuenta

• Costo de inicio en frío: La primera sesión cuesta aproximadamente un 13% más que la línea base sin grafo debido a la sobrecarga del esquema de herramientas (~5K tokens). Las sesiones con múltiples preguntas amortizan este costo.
• Soporte de lenguajes: La extracción profunda es mejor en JS/TS con pases conscientes del framework (Express, NestJS, Next.js, Redux Toolkit, React Router). Python/Ruby/Go/Java/Rust usan tree-sitter AST simple. C/Kotlin/C#/Scala/PHP/Swift/Zig usan un extractor estructural genérico.
• Límites: Esto es un mapa estructural para un agente, no una base de datos de análisis de programas completa. Las rutas con mucho meta-programación recurren al AST base.

El autor busca activamente contraejemplos — repositorios donde el corte estructural falle. Licencia MIT, requiere Node 20+.