¿Qué es codebase-memory-mcp?
codebase-memory-mcp, de DeusData, analiza un repositorio con 163 gramáticas de tree-sitter incluidas y lo convierte en un grafo de conocimiento en SQLite con funciones, clases, archivos, imports, llamadas, rutas y flujo de datos, que guarda en ~/.cache/codebase-memory-mcp entre sesiones. Desde la v0.12.0 el grafo también incorpora documentación en Markdown y PDF, registros de decisiones de arquitectura, Dockerfiles, manifiestos de Kubernetes, charts de Helm, Terraform y jobs de CI, de modo que un agente puede seguir un Service a través de su workload y su imagen hasta el programa que ejecuta el contenedor. Una pasada Hybrid LSP afina las aristas de llamada con resolución de tipos para 11 familias de lenguajes, entre ellas Python, TypeScript, Go, Java y Rust.
El servidor expone 17 herramientas MCP, entre ellas search_graph (búsqueda estructural, BM25 y semántica con un modelo de embeddings compilado dentro del binario), trace_path, detect_changes para el radio de impacto de un diff de git, y query_graph, de solo lectura y con una sintaxis parecida a Cypher. Su instalador configura 46 integraciones con clientes, entre ellos Claude Code, Codex, Gemini CLI, Cursor y OpenCode. Un visor opcional en el navegador, CBM Lens, está en beta abierta.
El repositorio se creó en febrero de 2026, usa licencia MIT, está escrito en C y tiene unas 48.500 estrellas y 4.000 forks. La última versión es la v0.12.1, del 16 de octubre de 2026. El paquete de npm registró unas 12.100 descargas y el de PyPI unas 2.100 en la semana hasta el 10 de noviembre.
Cómo instalar codebase-memory-mcp
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash¿Merece la pena codebase-memory-mcp?
codebase-memory-mcp abarca más partes de un sistema que cualquier otro grafo de código de esta categoría. Donde CodeGraph y GitNexus se quedan en los archivos fuente, este enlaza el código con los Dockerfiles, objetos de Kubernetes, charts de Helm, módulos de Terraform y pasos de CI que lo construyen y despliegan, así que trace_path puede responder "¿qué despliega este servicio?" además de "¿quién llama a esta función?". Esa amplitud llega con licencia MIT, algo que la licencia no comercial de GitNexus no puede igualar.
Las cifras publicadas son grandes, pero vienen de los autores. Un preprint de arXiv de marzo de 2026 firmado por los mantenedores informa de un uso de tokens 10 veces menor y 2.1 veces menos llamadas a herramientas que la exploración archivo por archivo en 31 repositorios. El README cronometra un indexado completo del kernel de Linux, 28M líneas en 75K archivos, en 3 minutos en un Apple M3 Pro, y consultas Cypher por debajo de 1 ms. No hemos encontrado ninguna réplica independiente.
Los valores por defecto en privacidad son mejores que los de sus rivales. El README dice que el binario no hace ninguna petición de red por iniciativa propia, no busca actualizaciones y no recoge telemetría, mientras que CodeGraph y CocoIndex Code envían datos de uso salvo que se les diga lo contrario. La búsqueda semántica usa un modelo de embeddings compilado en el binario, sin Ollama ni clave de API. Las versiones incluyen procedencia SLSA Level 3, firmas cosign, sumas de verificación y análisis de VirusTotal; Microsoft Defender aún marca algunas compilaciones, algo que el proyecto documenta como falso positivo.
La instalación pesa más de lo que sugiere la lista de herramientas. El inicio rápido es un script de curl a bash, y los binarios de la v0.12.0 ocupaban de 331 a 335 MB, tanto que rompieron los instaladores de npm, PyPI y Go hasta la v0.12.1. El instalador añade hooks por defecto; en Claude Code incluyen un hook PreToolUse no bloqueante sobre Grep, Glob y Bash que inyecta contexto del grafo, y se quitan con install --no-hooks. index_repository acepta cualquier ruta salvo que se defina CBM_ALLOWED_ROOT.
La madurez es la verdadera duda. Hay unas 487 issues abiertas, entre ellas un informe de fuga de memoria abierto desde junio y otro de uso alto de CPU desde marzo, y solo la v0.12.0 fusionó 231 pull requests. El artefacto de grafo compartido por el equipo es opcional, pero el README advierte de que hacer commit de cada actualización hizo crecer el historial de un equipo hasta unos 6 GB en 350 commits.
Dónde se gana su sitio
Un ingeniero de plataforma en una empresa que ejecuta sus servicios en Kubernetes
Saber a qué despliegues e imágenes llega un cambio en una biblioteca compartida
Indexa el monorepo con index_repository y pide al agente que ejecute detect_changes sobre la rama y trace_path en los modos deploy y run. Sigue el camino Service, workload, imagen, Dockerfile y programa; los valores de Helm con plantillas que no puede resolver se omiten, así que confirma los huecos con check_index_coverage.
Un equipo de C/C++ con una batería de tests de CI lenta
Ejecutar solo los tests a los que puede afectar una pull request
La capa experimental Smart CI combina alcance estático con cobertura por test y vuelve a run_all cuando faltan pruebas. Solo acota código C/C++ con harnesses compatibles; empieza en modo sombra de solo informe, como aconseja el README.
Una responsable de ingeniería en una empresa regulada que extiende los agentes a todo el equipo técnico
Dar a todos contexto de grafo de código sin contrato con un proveedor ni datos que salgan de los portátiles
La licencia MIT, la ausencia de telemetría y de servicio alojado dejan nada que negociar. Define CBM_ALLOWED_ROOT en la configuración gestionada para acotar el indexado y decide de antemano si mantener los hooks por defecto o instalar con --no-hooks.
Antes de decidirte
- Puesta en marcha
- Descarga con curl el script install.sh (o install.ps1 en Windows), o usa npm, PyPI, Homebrew, AUR, Nix o go install; también hay un plugin para Claude Code. El instalador detecta los clientes y escribe la configuración MCP, skills, tres perfiles de agente y hooks; reinicia el agente y di "Index this project". auto_index está desactivado por defecto.
- Integraciones
- 17 herramientas: index_repository, list_projects, delete_project, index_status, check_index_coverage, search_graph, trace_path, detect_changes, query_graph, get_graph_schema, compare_graphs, get_code_snippet, get_file_outline, get_architecture, search_code, manage_adr e ingest_traces. Ninguna herramienta edita el código fuente: las escrituras van al índice, a su documento ADR y, solo con persistence: true, a una instantánea del grafo en la carpeta .codebase-memory del repositorio.
- Datos y privacidad
- Los índices y el grafo se guardan en local en ~/.cache/codebase-memory-mcp; el README dice que el binario no envía telemetría ni hace peticiones de red no solicitadas. CBM Lens escucha en 127.0.0.1 solo cuando se inicia, y su modelo opcional para el navegador se descarga de Hugging Face. No hay avisos de seguridad publicados.
- Coste a escala
- Gratuito; los únicos costes son CPU, RAM y disco locales. La memoria del indexado se puede limitar con index_max_rss_mb o CBM_MEM_BUDGET_MB. El ahorro se nota en la factura del modelo, con menos lecturas de archivos por pregunta.
- Límites
- Solo stdio; un transporte HTTP nativo es una petición de función abierta. Las llamadas de indexado síncronas largas pueden superar los plazos del cliente, así que los repositorios grandes necesitan el modo asíncrono. Hybrid LSP cubre 11 familias de lenguajes; el resto recurre a resolución textual. Todos los procesos activos deben ejecutar exactamente la misma compilación.
Lo bueno
- El grafo abarca código, documentación, Docker, Kubernetes, Helm, Terraform y CI
- Licencia MIT; sin telemetría ni llamadas de red desde el binario
- Consultas Cypher de solo lectura y radio de impacto de diffs en 17 herramientas
- Versiones firmadas con procedencia SLSA Level 3
Lo malo
- Unas 487 issues abiertas, incluidas quejas de memoria y CPU
- El instalador añade hooks a las llamadas de herramientas del agente por defecto
- Binarios de más de 330 MB; inicio rápido con curl a bash
- El ahorro de tokens que destaca procede del estudio de los propios mantenedores
Ideal para
Equipos cuyos agentes necesitan rastrear cambios entre servicios y configuración de despliegue, con una licencia que la empresa acepte y sin que nada salga de la máquina.
Alternativas a codebase-memory-mcp
codebase-memory-mcp: preguntas frecuentes
- ¿Merece la pena codebase-memory-mcp?
- El grafo de código más amplio que puedes usar con licencia MIT, desde funciones hasta charts de Helm y sin telemetría, siempre que aceptes sus hooks de instalación y una lista de casi 500 issues abiertas. Le damos un 4.2 sobre 5.
- ¿Cuánto cuesta codebase-memory-mcp?
- Gratuito y de código abierto (MIT). Sin plan alojado, cuenta ni clave de API.
- ¿Qué inconvenientes tiene codebase-memory-mcp?
- Unas 487 issues abiertas, incluidas quejas de memoria y CPU; el instalador añade hooks a las llamadas de herramientas del agente por defecto; binarios de más de 330 MB; inicio rápido con curl a bash; el ahorro de tokens que destaca procede del estudio de los propios mantenedores.
- ¿Para quién es codebase-memory-mcp?
- Equipos cuyos agentes necesitan rastrear cambios entre servicios y configuración de despliegue, con una licencia que la empresa acepte y sin que nada salga de la máquina.
- ¿Cuánto cuesta codebase-memory-mcp para un equipo o en producción?
- Gratuito; los únicos costes son CPU, RAM y disco locales. La memoria del indexado se puede limitar con index_max_rss_mb o CBM_MEM_BUDGET_MB. El ahorro se nota en la factura del modelo, con menos lecturas de archivos por pregunta.
- ¿Es codebase-memory-mcp seguro para los datos de la empresa?
- Los índices y el grafo se guardan en local en ~/.cache/codebase-memory-mcp; el README dice que el binario no envía telemetría ni hace peticiones de red no solicitadas. CBM Lens escucha en 127.0.0.1 solo cuando se inicia, y su modelo opcional para el navegador se descarga de Hugging Face. No hay avisos de seguridad publicados.
- ¿Cuáles son las mejores alternativas a codebase-memory-mcp?
- Las alternativas más cercanas que hemos analizado son CodeGraph, GitNexus, code-review-graph, Serena y CocoIndex Code.
Respuestas comprobadas el 11 nov 2026.
¿Desarrollas codebase-memory-mcp? Muestra esta nota en tu web
