GAIIA Unified MCP Server (v2.0.0)

GAIIA Unified MCP Server — это сервер Model Context Protocol (MCP) корпоративного класса, который подключает ИИ-ассистентов для написания кода и автономных агентов к экосистеме GAIIA. Он обеспечивает экспертно-управляемые аудиты кода, преобразования проектов, запуск BPMN-процессов и исследование API через несколько протоколов.

🌟 Возможности и функции

• Выбор эксперта и маршрутизация манифеста: Просматривайте и выбирайте из реестра Proxy Experts (например, Clean Architecture, Security, Performance, Transit domain).

• Трансформация и аудит кода: Преобразуйте отдельные блоки кода или проводите аудит всего репозитория на соответствие неизменным архитектурным стандартам.

• Мультипротокольное исследование API: Выполняйте фаззинг и обнаружение схем для различных протоколов:

  • REST (JSON): синтез OpenAPI v3.

  • GraphQL: интроспекция схем и автоматическая генерация инструментов.

  • gRPC (Protobuf): проверка серверной рефлексии (src/mock/mock-grpc-server.ts).

  • ISO 8583 (TCP Socket): взаимодействие с raw-сокетами для платёжных шлюзов (src/mock/mock-tcp-server.ts).

  • XML / SOAP: автоматический разбор .xsd и .wsdl файлов.

  • EDI (ANSI X12): восстановление сегментов для устаревших корпоративных форматов цепочек поставок.

  • OData и ERP: разрешение корпоративных метаданных (src/mock/mock-erp-server.ts).

• Оркестрация BPMS: Перечисляйте BPMN-шаблоны и запускайте выполнение рабочих процессов в gaiia-process-management.

• Телеметрия и хранение контекста: отслеживание контекста в памяти и запись телеметрии через src/services/telemetry-service.ts.

Related MCP server: docsgrep

⚙️ Установка и сборка

Предварительные требования

• Node.js: v20+ LTS

• npm: v9+

• Зарегистрированная учётная запись GAIIA для синхронизации облачного реестра

Настройка

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

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

🔐 Аутентификация

Выполните аутентификацию с платформой GAIIA, чтобы сохранять токены сеанса локально:

npm run login

Токены безопасно кэшируются в ~/.gaiia/auth.json.

🔧 Конфигурация окружения (.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

🔌 Конфигурация MCP-клиента (например, Claude Desktop)

Добавьте сервер в ваш claude_desktop_config.json:

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

🛠️ Справочник доступных MCP-инструментов

🧪 Локальное тестирование и мультипротокольные mock-серверы

Сервер включает автономные mock-серверы в src/mock/ для тестирования сложных протоколов без внешних зависимостей:

# 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

📄 Лицензия

MIT © 2026 GAIIA Engineering