GAIIA Unified MCP Server (v2.0.0)

El GAIIA Unified MCP Server es un servidor Model Context Protocol (MCP) de nivel empresarial que conecta asistentes de codificación de IA y agentes autónomos con el ecosistema GAIIA. Permite auditorías de código guiadas por expertos, transformaciones de proyectos, activación de procesos BPMN e interrogación de API multiprotocolo.

🌟 Capacidades y características

• Selección de expertos y enrutamiento de manifiestos: Explore y seleccione de un registro de Proxy Experts (p. ej., Clean Architecture, Security, Performance, dominio Transit).

• Transformación y auditoría de código: Transforme bloques de código individuales o realice auditorías en todo el repositorio contra estándares arquitectónicos inmutables.

• Interrogación de API multiprotocolo: Realice fuzzing y descubra esquemas en diversos protocolos:

  • REST (JSON): síntesis de OpenAPI v3.

  • GraphQL: introspección de esquemas y generación automática de herramientas.

  • gRPC (Protobuf): inspección de reflexión de servidor (src/mock/mock-grpc-server.ts).

  • ISO 8583 (TCP Sockets): comunicación de socket sin procesar para pasarelas de pago (src/mock/mock-tcp-server.ts).

  • XML / SOAP: análisis automático de .xsd y .wsdl.

  • EDI (ANSI X12): reparación de segmentos para formatos heredados de cadena de suministro empresarial.

  • OData y ERP: resolución de metadatos empresariales (src/mock/mock-erp-server.ts).

• Orquestación de procesos BPMS: Liste los planos BPMN y active ejecuciones de flujos de trabajo en gaiia-process-management.

• Telemetría y retención de contexto: seguimiento de contexto en memoria y registro de telemetría mediante src/services/telemetry-service.ts.

Related MCP server: docsgrep

⚙️ Instalación y compilación

Requisitos previos

• Node.js: v20+ LTS

• npm: v9+

• Una cuenta GAIIA registrada para la sincronización del registro en la nube.

Configuración

# 1. Navigate to directory
cd gaiia-mcp-server

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

🔐 Autenticación

Autentíquese con la plataforma GAIIA para almacenar en caché los tokens de sesión localmente:

npm run login

Los tokens se almacenan en caché de forma segura en ~/.gaiia/auth.json.

🔧 Configuración del entorno (.env)

GAIIA_GRAPHQL_ENDPOINT=https://<api-id>.appsync-api.ap-southeast-2.amazonaws.com/graphql
AWS_REGION=ap-southeast-2
USER_POOL_ID=ap-southeast-2_xxxxxxxxx
APP_CLIENT_ID=xxxxxxxxxxxxxxxxxxxxxxxxxx

🔌 Configuración del cliente MCP (p. ej., Claude Desktop)

Añada el servidor a su claude_desktop_config.json:

{
  "mcpServers": {
    "gaiia-unified-mcp": {
      "command": "node",
      "args": ["c:/programming/aiia/gaiia-mcp-server/build/index.js"]
    }
  }
}

🛠️ Referencia de herramientas MCP disponibles

🧪 Pruebas locales y servidores simulados multiprotocolo

El servidor incluye servidores simulados independientes en src/mock/ para probar protocolos complejos sin dependencias externas:

# Start mock gRPC server
npx tsx src/mock/mock-grpc-server.ts

# Start mock ISO 8583 TCP socket server
npx tsx src/mock/mock-tcp-server.ts

# Start mock ERP / OData server
npx tsx src/mock/mock-erp-server.ts

📄 Licencia

MIT © 2026 GAIIA Engineering