GAIIA Unified MCP Server (v2.0.0)

Der GAIIA Unified MCP Server ist ein unternehmensreifer Model-Context-Protocol-Server, der KI-Codierungsassistenten und autonome Agenten mit dem GAIIA-Ökosystem verbindet. Er ermöglicht expertengeleitete Code-Audits, Projekt-Transformationen, BPMN-Prozessauslösung und Multi-Protokoll-API-Analyse.

🌟 Funktionen & Fähigkeiten

• Expertenauswahl & -Routing: Durchsuchen und Auswählen aus einer Registry von Proxy-Experten (z. B. Clean Architecture, Security, Performance, Transit-Domäne).

• Code-Transformation & Auditing: Transformieren einzelner Codeblöcke oder Durchführen umfassender Audits gegen unveränderliche Architekturstandards.

• Multi-Protokoll-API-Abfrage: Schemaerkennung und -synthese über verschiedene Protokolle:

  • REST (JSON): OpenAPI-v3-Synthese.

  • GraphQL: Schema-Introspection und automatische Tool-Generierung.

  • gRPC (Protobuf): Server-Reflection-Inspektion (src/mock/mock-grpc-server.ts).

  • ISO 8583 (TCP-Sockets): Direkte Socket-Kommunikation für Zahlungsgateways (src/mock/mock-tcp-server.ts).

  • XML / SOAP: Automatisches Parsen von .xsd- und .wsdl-Dateien.

  • EDI (ANSI X12): Segment-Reparatur für Altsysteme im Bereich Supply-Chain-Formate.

  • OData & ERP: Auflösung von Unternehmensmetadaten (src/mock/mock-erp-server.ts).

• BPMS-Prozessorchestrierung: BPMN-Vorlagen auflisten und Workflow-Ausführungen in gaiia-process-management auslösen.

• Telemetrie & Kontextspeicherung: In-Memory-Kontextverfolgung und Telemetrieprotokollierung über src/services/telemetry-service.ts.

Related MCP server: docsgrep

⚙️ Installation & Build

Voraussetzungen

• Node.js: v20+ LTS

• npm: v9+

• Ein registriertes GAIIA-Konto für die Synchronisierung mit der Cloud-Registrierung

Einrichtung

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

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

🔐 Authentifizierung

Authentifizieren Sie sich mit der GAIIA-Plattform, um Sitzungstoken sicher zu speichern:

npm run login

Token werden sicher unter ~/.local/share/gaiia/tokens.json oder einem anderen konfigurierten Pfad gespeichert.

🔧 Umgebungskonfiguration

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

🔌 MCP-Client-Konfiguration (z. B. Claude Desktop)

Fügen Sie den Server zu Ihrer claude_desktop_config.json hinzu:

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

🛠️ Referenz der verfügbaren MCP-Tools

🧪 Tests & lokale Mock-Server

Der Server enthält eigenständige Mock-Server in src/mock/ zum Testen komplexer Protokolle ohne externe Abhängigkeiten:

# 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

📄 Lizenz

MIT © 2026 GAIIA Engineering