Sobre el proyecto

codebase-memory-mcp es un motor de inteligencia de código diseñado para servir a agentes de codificación AI a través del Model Context Protocol (MCP). Analiza un repositorio en un grafo de conocimiento persistente de funciones, clases, cadenas de llamadas, rutas HTTP y enlaces entre servicios, luego responde consultas estructurales contra dicho grafo. Características clave documentadas en el README: - Indexación: análisis AST de tree-sitter con 162 gramáticas compiladas en el binario. Una tubería RAM-first utiliza compresión LZ4, SQLite en memoria y coincidencia de patrones Aho-Corasick. El README reporta indexar el kernel de Linux (28M LOC, 75K archivos) en aproximadamente 3 minutos. - Hybrid LSP: una implementación ligera en C de algoritmos de resolución de tipos para Python, TypeScript/JavaScript/JSX/TSX, PHP, C#, Go, C, C++, Java, Kotlin, Rust y Perl, cubriendo enlace de parámetros, inferencia de tipo de retorno, sustitución genérica y patrones de resolución específicos del lenguaje. - Superficie de consulta: 15 herramientas MCP incluyendo vista general de arquitectura, trazado de grafos de llamadas, análisis de impacto, detección de código muerto, consultas tipo Cypher, búsqueda semántica, búsqueda full-text BM25 y búsqueda de código. El README reporta consultas estructurales submilisegundo y reducción de tokens versus exploración archivo por archivo. - Modelo de grafo: tipos de arista como CALLS, IMPORTS, DEFINES, IMPLEMENTS, INHERITS, HTTP_CALLS, EMITS, LISTENS_ON, DATA_FLOWS, SIMILAR_TO y SEMANTICALLY_RELATED. Las aristas CROSS_* entre repositorios conectan nodos a través de repositorios en el mismo almacén. - Infraestructura como código: Dockerfiles, manifiestos de Kubernetes y superposiciones Kustomize se indexan como nodos de grafo con referencias cruzadas. - Distribución: un único ejecutable nativo para macOS, Linux y Windows, sin entorno de ejecución de lenguaje, servicio alojado ni clave API requerida. También disponible vía npm, PyPI, Homebrew, Scoop, Winget, Chocolatey, AUR y go install. Todo el procesamiento es local. - Operación: un comando de instalación detecta y configura automáticamente agentes de codificación compatibles. Un daemon compartido de coordinación gestiona observadores en segundo plano, trabajos de indexación y la interfaz opcional. Auto-index y auto-watch son configurables. Una interfaz visual de grafo 3D integrada se sirve en localhost:9749. - Compartición de equipo: un snapshot opcional de SQLite comprimido zstd (.codebase-memory/graph.db.zst) puede comprometerse al repositorio para que compañeros inicien desde el artefacto y ejecuten indexación incremental en lugar de una nueva indexación completa. El proyecto no integra un LLM; el cliente MCP actúa como la capa de inteligencia que traduce preguntas en lenguaje natural a consultas del grafo. El README referencia un preprint (arXiv:2603.27277) que describe el diseño y benchmarks, y documenta prácticas de seguridad que incluyen procesamiento exclusivamente local y verificación de artefactos de lanzamiento.