Skip to content

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,422 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 codebase-memory-mcp

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.


📋 Descripción General

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.

Características Principales:

  • 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.

🛠️ Tecnologías y Librerías Utilizadas

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.nix y flake.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.cbm para 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-format y clang-tidy para formateo y análisis estático de C.
    • cppcheck para la prevención de fugas de memoria y errores de punteros.
    • Biome para el análisis de los archivos de configuración y JSON.

📁 Estructura del Repositorio

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 YAML

🚀 Instalación y Ejecución Local

Dispones de múltiples vías para compilar y arrancar codebase-memory-mcp dependiendo de tu entorno de desarrollo.

Opción 1: Usando Nix (Recomendado)

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.cbm

Opción 2: Compilación Nativa (Linux / macOS)

Asegú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 --server

Opción 3: Ejecución mediante Docker

Puedes 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-mcp

⚙️ Gobernanza del Proyecto

Este 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 lefthook ejecutando formateo de código (clang-format y biome) 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 en src/foundation/recursion_whitelist.h con el fin de evitar desbordamientos de pila (stack overflow).
  • Filtro Antierrores (no-mistakes): El proxy de Git integrado mediante .no-mistakes.yaml previene el empuje accidental de ramas rotas, credenciales expuestas en archivos .env locales o código que no pase las pruebas unitarias básicas.

Megacore - Automatizando y estandarizando la calidad del software en Megasoft.

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages