GAIIA Unified MCP Server (v2.0.0)

GAIIA Unified MCP Server는 AI 코딩 어시스턴트와 자율 에이전트를 GAIIA 생태계에 연결하는 엔터프라이즈급 Model Context Protocol (MCP) 서버입니다. 전문가 가이드 코드 감사, 프로젝트 변환, BPMN 프로세스 트리거링, 멀티프로토콜 API 인터로게이션을 지원합니다.

🌟 기능 및 특징

• 전문가 선택 및 매니페스트 라우팅: 프록시 전문가(예: Clean Architecture, Security, Performance, Transit 도메인) 레지스트리에서 탐색하고 선택합니다.

• 코드 변환 및 감사: 개별 코드 블록을 변환하거나 변경할 수 없는 아키텍처 표준에 따라 저장소 전체 감사를 수행합니다.

• 멀티프로토콜 API 인터로게이션: 다양한 프로토콜에서 스키마를 퍼징하고 발견합니다:

  • REST (JSON): OpenAPI v3 합성.

  • GraphQL: 스키마 인트로스펙션 및 자동 도구 생성.

  • gRPC (Protobuf): 서버 리플렉션 검사 (src/mock/mock-grpc-server.ts).

  • ISO 8583 (TCP Sockets): 결제 게이트웨이를 위한 원시 소켓 통신 (src/mock/mock-tcp-server.ts).

  • XML / SOAP: .xsd 및 .wsdl 자동 파싱.

  • EDI (ANSI X12): 레거시 엔터프라이즈 공급망 형식의 세그먼트 복구.

  • OData & ERP: 엔터프라이즈 메타데이터 해석 (src/mock/mock-erp-server.ts).

• BPMS 프로세스 오케스트레이션: gaiia-process-management에서 BPMN 청사진을 나열하고 워크플로 실행을 트리거합니다.

• 텔레메트리 및 컨텍스트 유지: 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