Code-Graph-MCP: El Servidor MCP de Código Abierto Reduce el Uso de Tokens de Código de Claude en un 40-60%

code-graph-mcp es un servidor MCP de código abierto que indexa bases de código en un grafo de conocimiento AST para reducir el uso de tokens de Claude Code. En lugar de que Claude realice múltiples llamadas grep/read/glob para comprender la estructura del código, consulta el grafo para obtener respuestas estructuradas en llamadas únicas.

Cómo Funciona

La herramienta analiza código con Tree-sitter, extrae símbolos (funciones, clases, tipos, interfaces) y sus relaciones (llamadas, importaciones, herencia, exportaciones, vinculaciones de rutas HTTP), luego almacena todo en SQLite con búsqueda de texto completo FTS5 y sqlite-vec para similitud vectorial. Soporta 10 lenguajes: TypeScript, JavaScript, Go, Python, Rust, Java, C, C++, HTML y CSS.

Herramientas Principales

• project_map — Vista general de arquitectura completa en una llamada (módulos, dependencias, funciones activas, puntos de entrada)
• semantic_code_search — Búsqueda híbrida que combina BM25 + similitud vectorial con fusión RRF
• get_call_graph — Rastrear llamantes/llamados con CTEs recursivos
• impact_analysis — Ver todo lo que depende de una función antes de cambiarla
• trace_http_chain — Rastrear rutas HTTP desde el manejador hasta la llamada a BD (soporta Express, Flask/FastAPI, Go)
• module_overview, dependency_graph, find_similar_code, get_ast_node — Funciones adicionales del kit de herramientas

Resultados de Eficiencia

En un proyecto Rust de 33 archivos:

• Comprensión de arquitectura del proyecto: Reducido de 5-8 llamadas a herramientas a 1 llamada
• Seguimiento de cadena de llamadas de 2 niveles: Reducido de 8-15 llamadas a 1 llamada
• Análisis de impacto pre-cambio: Reducido de 10-20+ llamadas a 1 llamada
• Búsqueda de función por concepto: Reducido de 3-5 llamadas a 1 llamada

En general: ~80% menos llamadas a herramientas por tarea de navegación, ~95% menos código fuente volcado en contexto, y ahorros del 40-60% en tokens de sesión totales.

Detalles Técnicos

La indexación incremental usa árbol Merkle BLAKE3 para rastrear hashes de contenido — solo los archivos modificados se vuelven a analizar. Los subárboles de directorio sin cambios se omiten completamente mediante caché mtime. Cuando cambia la firma de una función, la propagación de cambios regenera automáticamente el contexto para todos los llamantes descendentes.

La herramienta tiene cero dependencias externas — es un binario único de 19MB con SQLite integrado y sqlite-vec incluido. No requiere Docker, API en la nube ni servidor de base de datos. Las incrustaciones locales opcionales usan un modelo de incrustación basado en Candle, con compuerta de características para que puedas compilar sin él si no necesitas búsqueda vectorial.

Instalación

Funciona con Claude Code, Cursor, Windsurf o cualquier cliente MCP.

Plugin de Claude Code (recomendado):

/plugin marketplace add sdsrss/code-graph-mcp
/plugin install code-graph-mcp

Esto incluye el servidor MCP más comandos de barra (/understand, /trace, /impact), ganchos de auto-indexación (re-indexa en cada edición de archivo), visualización de estado StatusLine y actualizaciones automáticas.

Para cualquier cliente MCP:

npx -y @sdsrs/code-graph

O añade a tu configuración MCP:

{
  "mcpServers": {
    "code-graph": {
      "command": "npx",
      "args": ["-y", "@sdsrs/code-graph"]
    }
  }
}

Cuándo No Usarlo

grep sigue siendo mejor para búsqueda exacta de cadenas/constantes. Si necesitas encontrar cada ocurrencia de TODO o un código de error específico, usa grep. code-graph-mcp brilla cuando necesitas comprender estructura, relaciones y arquitectura de código.