🗺️ Servidor MCP CodeAtlas

Un servidor MCP independiente que expone los datos de análisis de CodeAtlas a asistentes de IA: Gemini, Claude, Cursor, Windsurf, VS Code Copilot y más.

NOVEDAD en v1.4.0: 🧠 Memoria del Sistema de IA — La IA recuerda el flujo de tu sistema entre conversaciones.

⚡ Inicio Rápido

1. Analiza tu proyecto

Instala la extensión de VS Code de CodeAtlas y luego ejecuta:

Ctrl+Shift+P → CodeAtlas: Analyze Project

Esto genera .codeatlas/analysis.json en la raíz de tu proyecto.

2. Añade la configuración MCP

Elige tu asistente de IA y añade la configuración:

Abre Settings (Ctrl+,) → busca mcp → haz clic en Edit in settings.json, luego añade:

{
  "mcp": {
    "servers": {
      "codeatlas": {
        "command": "npx",
        "args": ["-y", "@giauphan/codeatlas-mcp"]
      }
    }
  }
}

O añádelo a través del archivo .vscode/settings.json del área de trabajo para una configuración por proyecto.

Añade a .gemini/settings.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Añade a .cursor/mcp.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Añade a .windsurf/mcp.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

¡Eso es todo! Tu asistente de IA ahora puede consultar la estructura, dependencias y conocimientos de tu base de código.

🛠️ Herramientas Disponibles

Análisis de Código (6 herramientas)

🧠 Memoria del Sistema de IA (3 herramientas — NUEVO en v1.4.0)

🧠 Memoria del Sistema de IA

Los asistentes de IA pierden el contexto entre conversaciones. CodeAtlas MCP resuelve esto con archivos de memoria persistente.

Cómo funciona

Conversation 1 → AI writes code → calls sync_system_memory
                                          │
                                   .agents/memory/
                                   ├── system-map.md
                                   ├── modules.json
                                   ├── business-rules.json
                                   ├── conventions.md
                                   ├── feature-flows.json
                                   └── change-log.json
                                          │
Conversation 2 → AI reads .agents/memory/ → knows full system flow instantly

Configurar la Memoria de la IA

1. Copia las plantillas de reglas a tu proyecto:

mkdir -p /path/to/your-project/.agents/rules/

2. Crea .agents/rules/auto-memory.md con la regla que le indica a la IA que:

   • Lea .agents/memory/ al inicio de cada conversación

   • Use trace_feature_flow antes de realizar cambios

   • Llame a sync_system_memory después de completar los cambios

3. Ejecuta sync_system_memory una vez para generar la instantánea de memoria inicial.

📖 Guía completa de configuración y plantillas de reglas: Documentación de CodeAtlas

📦 Alternativa: Instalación Global

Si prefieres instalar globalmente en lugar de usar npx:

npm install -g @giauphan/codeatlas-mcp

Luego usa "command": "codeatlas-mcp" (no se necesitan args) en tu configuración MCP.

🔧 Variables de Entorno

Por defecto, el servidor autodescubre todos los proyectos con .codeatlas/analysis.json bajo tu directorio de inicio.

🌐 Lenguajes Soportados

🧑💻 Desarrollo

git clone https://github.com/giauphan/codeatlas-mcp.git
cd codeatlas-mcp
npm install
npm run build
npm start

Licencia

MIT