GAIIA 统一 MCP 服务器（v2.0.0）

GAIIA 统一 MCP 服务器是一款企业级模型上下文协议（MCP）服务器，用于将 AI 编码助手和自主代理连接到 GAIIA 生态系统。它支持专家引导的代码审计、项目转换、BPMN 流程触发以及多协议 API 探测。

🌟 功能与特性

• 专家选择与清单路由：浏览并从代理专家注册表中选择（例如，清洁架构、安全、性能、交通领域）。

• 代码转换与审计：转换单个代码块，或根据不可变架构标准对整个代码库进行审计。

• 多协议 API 探测：跨多种协议进行模糊测试和模式发现：

  • REST（JSON）：OpenAPI v3 合成。

  • GraphQL：模式内省和自动工具生成。

  • gRPC（Protobuf）：服务器反射检查（src/mock/mock-grpc-server.ts）。

  • ISO 8583（TCP 套接字）：支付网关的原始套接字通信（src/mock/mock-tcp-server.ts）。

  • XML / SOAP：自动解析 .xsd 和 .wsdl 文件。

  • EDI（ANSI X12）：遗留企业供应链格式的段修复。

  • OData 与 ERP：企业元数据解析（src/mock/mock-erp-server.ts）。

• BPMN 流程编排：列出 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 工具参考

🧪 本地测试与多协议模拟服务器

该服务器包含 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 工程团队