MCP NEXO

Nuestra Arquitectura de Desarrollo MCP NEXO

En lugar de que un agente de IA ejecute todo el desarrollo "a mano" —levantar requisitos, leer la base de datos, escribir especificaciones, generar código, probar, documentar— NEXO divide el ciclo de vida del software en 16 nodos especializados encapsulados como servidores MCP independientes y actúa como orquestador central: recibe el objetivo, instancia un plan de ejecución desde un catálogo de 28 pipelines estandarizados, notifica a cada nodo qué herramienta ejecutar y grafica todo el proceso en tiempo real en un Monitor Neuronal 3D.

El resultado: cualquier agente compatible con MCP —Antigravity, Claude Code, Cursor, Devin, OpenCode, Codex, Gemini, Zed— se convierte en un "director" que dirige una orquesta de 16 micro-cerebros especializados, todo sobre el estándar abierto Model Context Protocol (JSON-RPC 2024-11-05). Y lo más importante: este mismo estándar se aplica a cada proyecto que desarrollamos, garantizando un ciclo de vida monitoreado y reproducible.

Arquitectura orbital: núcleo orquestador + 16 nodos MCP

Arquitectura MCP NEXO: servidor orquestador central con nodos satélite especializados en doble órbita

MCP.NEXO.Server en el núcleo; los 9 nodos de dominio en el anillo exterior y las 7 lunas de soporte en el anillo interior, persistiendo en .nexo/nexo.db por proyecto.

Decisiones clave de diseño

Un solo proceso, dos protocolos

MCP.NEXO.Server es a la vez un servidor MCP estándar por stdio (montable en cualquier IDE vía mcp_config.json) y un servidor web Kestrel que sirve el dashboard con API REST + SignalR. Sin demonios separados.

NEXO no ejecuta — orquesta

El orquestador construye el plan como un grafo de pasos (DAG con DependsOn), lo persiste y lo transmite. Es el agente llamador quien invoca físicamente las herramientas de cada satélite, que NEXO re-expone en su propio tools/list.

Puerto dinámico

Al arrancar, NEXO sondea los puertos 5000→5050 y toma el primero libre, escribiendo data/active_port.json para que otros procesos lo descubran automáticamente.

Persistencia SQLite doble

data/mcp-nexo.db (global del servidor) y .nexo/nexo.db por proyecto: historial de planes, etapas, telemetría y memoria cognitiva aislados por workspace.

Nuestro compromiso

NEXO no es una herramienta: es el estándar de desarrollo que aplicamos a todos los proyectos

Cuando desarrollamos software para tu empresa, el ciclo de vida completo —requisitos, diseño, código, pruebas, documentación y despliegue— corre sobre esta red orquestada. Eso significa entregas consistentes, trazabilidad total y la tranquilidad de que nada depende de la improvisación.

Todo proyecto sigue un pipeline registrado

Ningún desarrollo se improvisa: cada trabajo inicia con un plan formal instanciado desde el catálogo de 28 pipelines estandarizados, ejecutado paso a paso sobre el grafo de orquestación.

Ciclo de vida monitoreado en tiempo real

Cada paso reporta su estado cognitivo —análisis, ejecución, validación— y se grafica en vivo en el Monitor Neuronal 3D. Si un plan se interrumpe, se restaura desde la persistencia exactamente donde quedó.

Memoria y trazabilidad por proyecto

Cada proyecto se provisiona con .nexo/: SQLite aislada con historial de planes, etapas, telemetría y memoria cognitiva. Todo lo que se hizo queda auditado y reproducible.

Calidad como gate, no como opción

Los pipelines integran NEXTest (QA, cobertura, BDD), gobierno de drift arquitectónico (NEXVisual) y documentación viva (NEXDocs): la calidad se verifica dentro del proceso, no al final.

El estándar mejora solo

NEXKB registra el conocimiento procedural de cada ejecución y el motor de auto-aprendizaje sintetiza nuevos pipelines: cada proyecto deja el estándar mejor de lo que lo encontró.

Seguridad para el cliente

El mismo estándar disciplinado se aplica a todos los proyectos: software desarrollado con un ciclo de vida monitoreado, estandarizado, auditable y respaldado por nuestra metodología.

Los 16 nodos satélite

Cada nodo es un servidor MCP independiente con su propio proceso. NEXO los registra con slug, transporte, capacidades y lista de tools, y los renderiza en dos órbitas concéntricas. El tools/list de NEXO re-expone dinámicamente todas las tools de los 16 nodos: el agente ve un único servidor MCP con más de 190 herramientas disponibles.

Anillo exterior9 nodos de dominio — cubren el ciclo de vida del software

SQL C#

mcp-sqlcsharp

18 tools

Database & CRUD

SQL Server transaccional

Schema, CRUD procs, migraciones, índices, DDL, diccionario de datos, slow queries

ProjectRAG

mcp-projectrag

9 tools

Context & RAG

Contexto semántico de código

Embeddings ONNX + SQLite FTS5, search_context, find_class, find_method

SDD Engine

mcp-sdd

8 tools

Spec-Driven Architecture

Spec-Driven Development

Proyectos, artefactos, tareas, sesiones, entregables, diagramas

DimModel

mcp-dimmodel

10 tools

Dimensional BI

Data Warehouse / Kimball

Star schema, SCD, DDL, ETL map, capa semántica, staging

PowerBI

mcp-powerbi

9 tools

Analytics & Reports

Capa semántica BI

Modelos TOM, DAX, RLS, TMDL, PBIR, auditoría de gobernanza

FrontEnd

mcp-frontend

24 tools

Design & UI Systems

Gobernanza de diseño UI

Design tokens, WCAG 2.2, auto-fix, ingeniería inversa, export multi-plataforma

ExcelIntegrator

mcp-excelintegrator

8 tools

Spreadsheet ETL

Ingesta Excel → DB

Infer schema, DDL, import/export, limpieza y perfilado de datos

NEXTest

mcp-nextest

7 tools

QA & Testing

Automated Testing & QA Engine

TDD runner, suites, cobertura, mocks, BDD verify, mutation analysis

NEXDocs

mcp-nexdocs

7 tools

Living Documentation

Documentación técnica viva

ADRs, OpenAPI/Swagger, sync de specs, diagramas, changelog, manuales

Anillo interior7 lunas de soporte — capacidades transversales que todo pipeline puede invocar

NEXBabok

mcp-nexbabok

14 tools

Requirements Satellite

Análisis de negocio BABOK v3

Elicitación, reglas DMN/FEEL, EARS lint, Gherkin BDD, trazabilidad, gap As-Is/To-Be

NEXKB

mcp-nexkb

25 tools

Knowledge Intelligence

Base de conocimiento procedural

Memoria verificable, knowledge graph, comunidades Louvain, contradicciones

NEXGit

mcp-nexgit

11 tools

Git Satellite

Control de versiones

Ramas, commits semánticos, PRs, conflictos, stash, releases

NEXWeb

mcp-nexweb

7 tools

Web Satellite

Web intelligence (Playwright headless)

search, fetch, extract, render, crawl, sitemap, health

NEXFile

mcp-nexfile

10 tools

IO Satellite

File Intelligence Engine

Escritura atómica, safe patch con rollback, diff, checksum, watch

NEXGateway

mcp-nexgateway

13 tools

External Gateway Satellite

Federación de MCPs externos

Registro dinámico, proxy de tools, descubrimiento, feedback a NEXKB

NEXVisual

mcp-nexvisual

7 tools

Visual Architecture Satellite

Arquitectura visual viva

Diagramas C4/SVG/HTML, compilación desde código, detección de drift

El protocolo de orquestación

NEXO impone un contrato obligatorio a cualquier agente que trabaje en el workspace (codificado en AGENTS.md): antes de tocar un archivo, el agente registra su plan; cada paso reporta su estado cognitivo en vivo; al terminar, el plan se cierra y se archiva.

1. Registro del plan

•nexo_orchestrate { goal, templateSlug } — instancia un OrchestrationPlan desde el catálogo; los sinónimos ("crud", "bi", "spec") se resuelven a slugs canónicos.
•nexo_submit_plan { planName, goal, steps[] } — planes ad-hoc con pasos { mcpName, toolName, description }.

2. Ejecución con estados cognitivos

•nexo_step_start enciende el nodo en el grafo 3D con sub-estados: ANALYZING → INSPECTING_CAPABILITIES → EXECUTING → VALIDATING.
•El agente invoca la herramienta real del satélite (o usa nexo_execute_step para invocación mediada).
•nexo_step_complete disuelve el sub-nodo, lanza la ráfaga de partículas y archiva la tarjeta.

3. Control de ciclo de vida

•nexo_get_status · nexo_get_diagnostics · nexo_init_project · nexo_infer_state.
•nexo_restore_plan recupera planes interrumpidos desde SQLite; nexo_force_state desatasca pasos.
•nexo_reset_plan y nexo_complete_plan cierran todo lo pendiente con la barra al 100%.

4. Auto-aprendizaje

•nexo_learn_pipeline { goal } — el NexoAutoLearningEngine detecta intenciones sin plantilla.
•Sintetiza un pipeline nuevo, lo auto-registra en el catálogo y lo ejecuta: el sistema crece solo.

Planes como grafos (DAG)

Cada PlanStep soporta DependsOn para ejecución en grafo acíclico, IsCritical (un fallo crítico marca el plan como Failed) y DefaultParameters. Si el agente se interrumpe, el plan se restaura desde SQLite exactamente donde quedó.

28 pipelines estandarizados

El PipelineTemplateCatalog cubre el ciclo de vida completo del software: desde el análisis de requisitos BABOK hasta el delivery, la documentación viva y el gobierno de arquitectura. Cada proyecto que desarrollamos sigue uno de estos pipelines — no hay procesos improvisados.

Si un requerimiento no encaja en ninguna plantilla, el NexoAutoLearningEngine sintetiza un pipeline nuevo, lo registra en el catálogo y lo ejecuta: el estándar crece con cada proyecto.

Ciclo de vida completo

fullcycle-enterprise-devopsOrquestación unificada de los 16 nodos: BABOK → benchmarking → Git → specs → código → QA → docs → delivery (24 pasos)

babok-fullcycle-featureIngeniería con rigor BABOK v3: reglas DMN → rama Git → especificación → desarrollo → QA → entrega

enterprise-agile-deliveryElicitación BABOK → rama de feature → spec SDD → indexación RAG → generación y ejecución

spec-drivenSDD specs → RAG index → SQL schema → FrontEnd → deliverables (12 pasos)

full-stack-featureSpec → DB schema → componentes UI → reindex semántico

Análisis y requisitos

babok-spec-drivenBABOK v3 completo: elicitación → sinceramiento Paul-Elder → benchmarking web → PRD enriquecido (13 pasos)

Desarrollo backend y herramientas

db-first-crudSchema → análisis FK → RAG → CRUD procs → index hints → reindex

mcp-server-devSpec → tool schemas y contratos JSON-RPC → dispatcher → implementación de un nuevo MCP

library-sdk-devSpec → contratos de API → algoritmo core → type augmentation → SDK

cli-tool-devSpec → parser de comandos → worker loop → stream processing → CLI

ai-agent-runtimeSpec → prompts y grafo cognitivo → memoria semántica → tool dispatcher → runtime de agente

Datos y Business Intelligence

bi-pipelineSchema OLTP → star schema Kimball → SCD → DDL → ETL map → DAX → Excel

data-mesh-bi-lineagePerfilado Excel → DDL → Kimball → capa semántica Power BI → linaje de datos (12 pasos)

excel-to-dbPerfil Excel → infer schema → DDL → create tables → import → index

Web, conocimiento y gateway

web-scraping-etlNEXWeb crawl/extract → transform → SQL Server → index RAG

web-research-knowledgeResearch web → artefactos de conocimiento (SDD/RAG)

web-to-biScraping de mercado → modelo dimensional → dashboard PowerBI

knowledge-intelligenceFuentes → contexto RAG → conocimiento trazable → knowledge graph (NEXKB)

gateway-mesh-federationDescubrimiento de MCPs externos → health check → invocación federada (NEXGateway)

Archivos y documentos

file-assets-pipelineExploración de árbol → inspección de media → checksums SHA256 → empaquetado ZIP

safe-refactoring-patchInspección → contexto RAG → unified diff → patch transaccional con rollback

document-processing-pipelineDescubrimiento → lectura paginada → batch replace → backup ZIP

Calidad, Git y gobierno

test-driven-assuranceSpec SDD → criterios BDD Gherkin → scaffold de tests (Red) → ejecución (Green) → quality gate

git-feature-workflowRama aislada → exploración NEXFile → búsqueda RAG → patch atómico → commit semántico

architecture-drift-governanceEscaneo RAG → contratos SDD → detección de drift NEXVisual → trazabilidad BABOK (10 pasos)

Documentación y diseño

living-documentation-pipelineExploración → extracción RAG → ADRs NEXDocs → export OpenAPI → spec viva

design-system-uiIngeniería inversa de tokens → WCAG 2.2 → componentes → export multi-plataforma (15 pasos)

visual-c4-architectureContratos SDD → topología C4 interactiva → validación → detección de drift (NEXVisual)

Telemetría y Monitor Neuronal 3D

Cada plan, paso y evento de los satélites se transmite en vivo por SignalR (/hubs/nexo) a un dashboard web servido por el propio proceso NEXO. El grafo orbital 2D/3D muestra el doble anillo de satélites, el estado cognitivo de cada paso y la carga de trabajo en tiempo real.

El Monitor Neuronal en ejecución real

Monitor Neuronal NEXO: grafo orbital 3D con los nodos MCP en órbita, telemetría en vivo y plan activo

Vista real del dashboard: instancias concurrentes de agentes, cockpit del workspace, grafo neural con los satélites en órbita y el plan activo con sus etapas a la derecha.

Eventos tipados

PlanStarted, StepStarted, StepCompleted, PlanCompleted, McpStateChanged, PlanRestored, StepStateForced y PlanReset fluyen por SignalRTelemetryBroadcaster hacia el front-end.

API HTTP completa

/api/status, /api/project, /api/workspace/infer, /api/workspace/specs, /api/artifacts, /api/instances, /api/pipelines (trigger, learn-and-execute, simulate-step) y /api/diagnostics.

Gestión por proyecto (.nexo)

nexo_init_project aprovisiona .nexo/nexo.db (SQLite aislada), .nexo/monitor/ (suite web), nexo.json y lanzadores: cada proyecto conserva historial y memoria independientes.

Stack tecnológico

Núcleo y satélites

.NET 8 / ASP.NET Core (Kestrel)ModelContextProtocol SDKSignalR (telemetría push)Microsoft.Data.SqliteSerilog (logs rolling)ONNX + FTS5 (ProjectRAG)Playwright (NEXWeb headless)Server-Sent Events

Estructura del repo: src/MCP.NEXO.Core (motor) + src/MCP.NEXO.Server (host stdio + web) + publish/ (binario) + docs/ (specs SDD) + data/ (SQLite + logs).

Un ecosistema que ya cerró el ciclo — y sigue creciendo

La red pasó de 7 a 16 nodos en producción: testing, Git, archivos, documentación viva, requisitos BABOK, conocimiento, gateway externo y arquitectura visual ya son satélites activos. El horizonte sigue abierto:

mcp-nextest

QA Engine: TDD runner, suites, cobertura, mocks, BDD y quality gates que bloquean el plan.

mcp-nexgit

Ramas semánticas, commits atómicos por etapa, PRs y releases generados.

mcp-nexfile

File Intelligence Engine: escritura atómica, safe patch con rollback, diff y watch.

mcp-nexdocs

Documentación viva: ADRs, OpenAPI, sync de specs, changelog y manuales.

mcp-nexbabok

Análisis de requisitos BABOK v3: elicitación, DMN, EARS, Gherkin y trazabilidad.

mcp-nexkb

Knowledge Intelligence: memoria procedural verificable y knowledge graph.

mcp-nexgateway

Federación de MCPs externos: registro dinámico, proxy y descubrimiento.

mcp-nexvisual

Arquitectura visual viva: diagramas C4/SVG y detección de drift.

mcp-devopspróximo

Dockerfiles multi-stage, docker-compose, pipelines CI/CD y health checks de despliegue.

mcp-nexdeploypróximo

Gestión de releases y despliegues gobernados dentro del ciclo de vida NEXO.

Por qué MCP como fundamento

Interoperabilidad real

Cualquier IDE o agente que hable MCP se conecta sin código de integración: el AGENTS.md del workspace es el único contrato de comportamiento.

Composición sobre monolito

Cada capacidad es un proceso aislado, actualizable y testeable por separado; NEXO solo conoce su manifiesto (slug, comando, tools).

Observabilidad nativa

Como toda acción pasa por el bus de orquestación, la telemetría 3D y la memoria cognitiva salen "gratis".

Multi-agente / multi-harness

HarnessAdapterFactory normaliza al llamador (Antigravity, Devin, Cursor, Claude Code…) y la información del caller viaja en cada plan y evento.

NEXO — Unifying Intelligent Agents into a Single Cohesive Orchestration Network.