codebase-memory-mcp es un servidor de alto rendimiento escrito en C que implementa el Model Context Protocol (MCP) para proporcionar un sistema de memoria semántica, indexación y consulta de grafos de dependencias de código fuente.
El proyecto permite a modelos de lenguaje (LLMs) y agentes inteligentes indexar, consultar y comprender bases de código complejas a través de un motor de consultas inspirado en Cypher, análisis sintáctico (AST) y una interfaz de visualización en 3D interactiva integrada mediante un servidor web embebido.
A diferencia de las herramientas tradicionales de indexación basadas en scripts pesados, codebase-memory-mcp está diseñado bajo una filosofía de sistemas de bajo nivel, priorizando la velocidad, el consumo mínimo de memoria y el determinismo.
- Servidor MCP Integrado: Expone capacidades de análisis de código y consulta de grafos directamente a herramientas compatibles con Model Context Protocol (como Claude Desktop, Cursor, etc.).
- Motor de Consultas Cypher: Implementación ligera de un motor de búsqueda gráfica (
src/cypher/) para recorrer relaciones entre archivos, funciones, clases y dependencias de la base de código. - Perfilado Semántico y AST: Módulos avanzados para extraer perfiles de árboles de sintaxis abstracta (AST) y calcular métricas semánticas estructurales de los archivos del proyecto.
- Servidor Web y Visualización 3D: Un servidor HTTP nativo embebido que sirve una interfaz web interactiva capaz de renderizar la topología y relaciones del código en un entorno tridimensional (
layout3d). - Arquitectura de Memoria Optimizada: Utiliza un asignador de memoria por zonas (Arena Allocator), memoria virtual personalizada (
vmem), e interonización de cadenas (string interning) para garantizar un rendimiento predecible y evitar la fragmentación de memoria.
El núcleo del sistema está construido desde cero en C para garantizar portabilidad y velocidad, apoyándose en las siguientes tecnologías y herramientas:
- Lenguaje Base: C (Estándar moderno C11/C99).
- Entorno de Desarrollo y Sandbox: Nix (mediante
flake.nixyflake.lock) para garantizar un entorno reproducible y aislado. - Visualización & Frontend: HTML5, CSS3 y JavaScript moderno interactivo, empaquetado y servido por un servidor web embebido (
src/ui/httpd.c). - Compilación y Despliegue:
Makefile.cbmpara la compilación optimizada del binario de C, y Docker para despliegues contenerizados con Nginx como proxy reverso para la SPA de visualización. - Calidad de Código y Estilo:
clang-formatyclang-tidypara formateo y análisis estático de C.cppcheckpara la prevención de fugas de memoria y errores de punteros.Biomepara el análisis de los archivos de configuración y JSON.
La arquitectura del proyecto está modularizada de la siguiente manera:
├── .clang-format # Reglas de estilo para el código C
├── .clang-tidy # Reglas de análisis estático para C
├── .cppcheck # Configuración de análisis estático con Cppcheck
├── .gitleaksignore # Ignorados de análisis de credenciales
├── .no-mistakes.yaml # Configuración de políticas de push y pre-commit de Megasoft
├── AGENTS.md # Documentación y configuración para agentes autónomos
├── Dockerfile # Dockerfile multi-etapa (compilación y servidor de producción)
├── Makefile.cbm # Script de construcción optimizado para el binario C
├── biome.json # Configuración del linter/formatter Biome
├── flake.nix / flake.lock # Configuración del entorno de desarrollo reproducible con Nix
├── glama.json # Configuración de integraciones de LLM/Glama
├── install.sh / install.ps1# Scripts de instalación multiplataforma
├── mem0.yaml # Configuración de backend de memoria persistente semántica
├── nginx.conf # Configuración del servidor Nginx para producción
├── server.json # Configuración del servidor MCP
└── src/ # Código fuente del proyecto
├── main.c # Punto de entrada principal del servidor MCP
├── cypher/ # Motor de base de datos de grafos y parsing de Cypher
│ ├── cypher.c
│ └── cypher.h
├── semantic/ # Análisis semántico de código, AST y algoritmos de rotación/grafos
│ ├── ast_profile.c
│ ├── ast_profile.h
│ ├── rotsq.c
│ ├── rotsq.h
│ ├── semantic.c
│ └── semantic.h
├── ui/ # Servidor web embebido, assets estáticos y motor de layout 3D
│ ├── config.c / .h
│ ├── embedded_assets.h
│ ├── embedded_stub.c
│ ├── http_server.c / .h
│ ├── httpd.c / .h
│ ├── layout3d.c / .h
│ └── web/ # (Inyectado/Compilado en embedded_assets) Interfaz web 3D
└── foundation/ # Librería base: memoria, cadenas, criptografía y utilidades
├── arena.c / .h # Asignador de memoria tipo Arena
├── compat.c # Capa de compatibilidad de sistema operativo
├── compat_fs.h # Capa de compatibilidad de sistema de archivos
├── log.c / .h # Sistema de logging estructurado de alta velocidad
├── recursion_whitelist.h # Control de recursión permitida en análisis estático
├── sha256.c # Implementación nativa de hashing SHA256
├── str_intern.c # Tabla global de string interning
├── system_info.c # Recolección de métricas de hardware y sistema
├── vmem.h # Abstracción de memoria virtual
└── yaml.h # Parser ligero de archivos de configuración YAMLDispones de múltiples vías para compilar y arrancar codebase-memory-mcp dependiendo de tu entorno de desarrollo.
Si tienes Nix instalado con soporte para Flakes, puedes levantar un entorno de desarrollo reproducible con todas las herramientas preconfiguradas:
# Entrar al shell de desarrollo (tendrás gcc, make, clang-tidy, biome, etc.)
nix develop
# Compilar el proyecto con Makefile.cbm
make -f Makefile.cbmAsegúrate de tener instalado un compilador compatible con C11 (gcc o clang) y make.
# Compilar el binario ejecutable
make -f Makefile.cbm All
# Ejecutar el servidor MCP en modo interactivo
./codebase-memory-mcp --serverPuedes construir y ejecutar el contenedor que compila la aplicación y expone tanto el puerto del servidor MCP como el servidor de visualización web de Nginx:
# Construir la imagen Docker
docker build -t codebase-memory-mcp .
# Levantar el contenedor
docker run -d -p 80:80 -p 8080:8080 --name codebase-memory-mcp codebase-memory-mcpEste repositorio sigue rigurosos estándares de calidad automáticos gestionados por el equipo de ingeniería de Megasoft:
- Validaciones Locales (Lefthook): Cada commit local es analizado por
lefthookejecutando formateo de código (clang-formatybiome) para asegurar que no se suba código mal estructurado. - Verificación de Recursión: Un script de análisis específico (
check-nolint-whitelist.sh) valida que el uso de recursión en C esté estrictamente limitado a las funciones declaradas ensrc/foundation/recursion_whitelist.hcon el fin de evitar desbordamientos de pila (stack overflow). - Filtro Antierrores (no-mistakes): El proxy de Git integrado mediante
.no-mistakes.yamlpreviene el empuje accidental de ramas rotas, credenciales expuestas en archivos.envlocales o código que no pase las pruebas unitarias básicas.
Megacore - Automatizando y estandarizando la calidad del software en Megasoft.