graphlens-mcp crea un grafo de código con un solo comando y reduce el gasto de tokens entre 10 y 23 veces

graphlens-mcp es un nuevo servidor MCP construido sobre el motor graphlens. Genera un grafo estructural del código con un solo comando y lo pone a disposición de un agente de IA de inmediato, sin código de integración manual.

Qué hace el motor

El motor graphlens toma código fuente en Python, TypeScript, Go, Rust y PHP y lo normaliza en un único grafo tipado. Los nodos son símbolos: funciones, clases, variables, métodos. Las aristas describen relaciones: `CALLS` (llamada), `HAS_TYPE` (tipo), `INHERITS_FROM` (herencia). Cada nodo recibe un ID SHA-256 determinista, de modo que el resultado es reproducible entre ejecuciones y apto para pipelines de agentes con caché.

La diferencia fundamental con grep es que el grafo entiende la semántica. Grep busca texto línea a línea: no sabe si la línea encontrada es el nombre de una función, un argumento o un comentario. El grafo opera con símbolos y sus relaciones. Si un backend en Python llama a un cliente en TypeScript, la arista `CALLS` cruza la frontera entre lenguajes y se conserva en el grafo. En monorepositorios y proyectos fullstack esto es crítico: las dependencias entre capas se vuelven objetos explícitos, no cadenas de texto que hay que rastrear a mano.

Qué mostró la medición sobre código real

El autor ejecutó 936 pruebas sobre apache/superset, un proyecto de código abierto con unas 400 mil líneas de código en Python y TypeScript. El límite de la prueba fueron los puntos de entrada `/api/v1/...`. Cada prueba debía responder preguntas del tipo «¿qué cambia si toco esta función?». 936 ejecuciones bastan para extraer conclusiones estadísticamente significativas.

Resultados:

• Análisis de impacto (impact analysis): el grafo es entre 10 y 23 veces más barato que grep en coste de tokens
• Consultas puntuales («busca la definición», «muestra las llamadas de un método»): la diferencia es mínima
• Cadenas entre lenguajes (Python → TypeScript): grep no las encuentra en absoluto; el grafo construye la ruta completa
• Estabilidad: los ID SHA-256 dan resultados reproducibles en ejecuciones repetidas del agente

Cuando hay que entender qué se romperá al modificar una función o una clase, el grafo gana por mucho. Cuando basta con encontrar una cadena por patrón, la diferencia es insignificante. El ahorro de tokens se nota más en bases de código grandes con mucha conexión entre módulos.

Del motor al producto terminado

Los artículos anteriores describían el motor graphlens en sí, la mecánica interna de construcción del grafo. Pero un motor no es un producto. Para conectarlo a un agente de IA había que instalar las dependencias, configurar la API y escribir una capa para un protocolo de interacción concreto. Para la mayoría de los desarrolladores es un obstáculo serio.

«Un motor no es un producto.

Para conectar de verdad graphlens a un agente no basta con pip install y una API. Hay que escribir un montón de código de integración», admite el autor.

graphlens-mcp cubre ese vacío. Por debajo está el mismo motor, pero encima hay un servidor MCP listo que acepta solicitudes del agente en un formato estandarizado justo después de la instalación.

MCP (Model Context Protocol) se ha convertido en el estándar de facto para integrar herramientas externas con modelos de lenguaje; lo admiten Claude, GPT y la mayoría de los frameworks de IA modernos. graphlens-mcp es compatible con cualquier agente que soporte este protocolo, sin configuración adicional.

La instalación requiere un solo comando. Según el autor, desde ese comando hasta el primer resultado real en un proyecto propio pasan cinco minutos. El producto está en fase alpha, con licencia MIT y se distribuye gratis.

Qué significa

Un grafo estructural de código como herramienta para agentes de IA no es teoría, sino una práctica medible con cifras concretas sobre código real. graphlens-mcp reduce la barrera de entrada para los equipos que construyen agentes de revisión de código, refactorización o análisis de dependencias: en lugar de montar la integración por su cuenta, tienen una herramienta lista con eficacia documentada. El código abierto y la licencia gratuita permiten probarla sin ningún compromiso comercial.