GAIIA Unified MCP Server (v2.0.0)

GAIIA Unified MCP Server は、AI コーディングアシスタントや自律エージェントを GAIIA エコシステムに接続する、エンタープライズ向け Model Context Protocol (MCP) サーバーです。エキスパート主導のコード監査、プロジェクト変換、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）。

• 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 ツールリファレンス

🧪 ローカルテストとマルチプロトコルモックサーバー

このサーバーには、外部依存関係なしで複雑なプロトコルをテストするためのスタンドアロンモックサーバーが 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