akdd-mcp v2.0.0

MCP server para Agentic KDD — expone 23 tools a Cursor, Claude Code, VS Code y cualquier cliente MCP.

Instalación

npm install -g @sistemasieq/akdd-mcp

O usar directamente con npx (sin instalar):

npx @sistemasieq/akdd-mcp

Configuración en Cursor

Crear o actualizar .cursor/mcp.json en el proyecto:

{
  "mcpServers": {
    "agentic-kdd": {
      "command": "npx",
      "args": ["akdd-mcp"],
      "env": {
        "PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}

Alternativa con ruta local (si tienes el archivo en el proyecto):

{
  "mcpServers": {
    "agentic-kdd": {
      "command": "node",
      "args": [".agentic/grafo/mcp-server.cjs"],
      "env": {
        "PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}

Configuración en Claude Code

# Agregar al proyecto
claude mcp add agentic-kdd -- node .agentic/grafo/mcp-server.cjs

# O con npx
claude mcp add agentic-kdd -- npx @sistemasieq/akdd-mcp

O en ~/.claude/mcp.json:

{
  "mcpServers": {
    "agentic-kdd": {
      "command": "npx",
      "args": ["akdd-mcp"],
      "env": {
        "PROJECT_ROOT": "/ruta/al/proyecto"
      }
    }
  }
}

Backward compatibility

Si el proyecto tiene Agentic KDD v2.x (sin módulos v3.2), el servidor arranca con las tools disponibles. Al iniciar muestra qué tools están activas y cuáles necesitan actualización.

[Agentic KDD MCP v2.0.0] ROOT=/mi/proyecto | 7/23 tools disponibles
  Tools no disponibles (módulos v3.x faltantes): ast_impact, ast_index, spec_waves...
  Para habilitarlas: actualizar Agentic KDD a v3.2 y copiar los archivos .cjs

Para actualizar a v3.2: descargar el ZIP de Agentic KDD y copiar los .cjs a .agentic/grafo/.

Las 23 tools

| Tool | Descripción | |------|-------------| | grafo_buscar | Búsqueda híbrida en 4 capas de memoria CoALA | | registrar_episodio | Registra episodio crudo en memoria episódica | | grafo_sync | Sincroniza markdown → SQLite | | grafo_impacto | Impacto semántico de una entidad | | registrar_entidad | Registra entidad en grafo semántico | | grafo_coala | Stats completo de las 4 capas CoALA | | grafo_predecir | Estimación de riesgo pre-tarea | | ast_impact | Impacto completo (AST + causal + knowledge) | | ast_index | Indexar proyecto en grafo AST | | ast_symbols | Símbolos de un archivo | | impact_precheck | Pre-check de impacto para un módulo | | impact_diff | Impacto combinado de varios archivos | | spec_waves | Waves de ejecución del spec | | spec_status | Estado del spec (% completado) | | spec_create | Crear spec nuevo (feature/bugfix) | | knowledge_query | Consultar ADRs y gotchas | | adr_ingest | Ingestar ADRs en knowledge base | | causal_add | Registrar edge causal | | causal_query | Consultar historial causal | | decision_trail | Trail completo de un ciclo | | decision_why | Explicar por qué existe algo | | recent_ciclos | Últimos N ciclos | | metrics_summary | KPIs del proyecto | | health_check | Diagnóstico del sistema | | memory_audit | Auditoría de memoria | | memory_forget | Olvidar entrada con razón | | verdad_vigente | Solo memoria vigente hoy |

Requisitos

• Node.js 18+
• Proyecto con Agentic KDD instalado (.agentic/ presente)
• SQLite: better-sqlite3 (recomendado) o Node.js 22+ (node:sqlite nativo)

Changelog

v2.0.0

• +16 tools nuevas (AST, specs, causal edges, decision trail, metrics, health, memory audit)
• Backward compatible con proyectos Agentic v2.x
• Detección automática de PROJECT_ROOT subiendo directorios
• Log de tools disponibles vs no disponibles al inicio

v1.0.2

• 7 tools core: grafo_buscar, registrar_episodio, grafo_sync, grafo_impacto, registrar_entidad, grafo_coala, grafo_predecir