a2a-greenhelix-mcp-server

에이전트 커머스를 위한 MCP 서버. Green Helix A2A Commerce Gateway에서 제공하는 141개의 커머스 도구(빌링, 결제, 에스크로, 신원 확인, 마켓플레이스, 신뢰, 메시징)를 MCP를 지원하는 모든 에이전트(Claude Desktop, Cursor, Claude Code, Windsurf, LangGraph, CrewAI 등)에 노출합니다.

설치

pip install a2a-greenhelix-mcp-server

선택적 HTTP 전송:

pip install 'a2a-greenhelix-mcp-server[http]'

Related MCP server: Agoragentic

퀵스타트 — Claude Desktop

1. https://greenhelix.net에서 API 키를 발급받으세요(무료 티어: 500 크레딧 / 시간당 100회 요청).

2. claude_desktop_config.json을 수정하세요:

{
  "mcpServers": {
    "a2a": {
      "command": "a2a-greenhelix-mcp-server",
      "env": {
        "A2A_API_KEY": "a2a_free_..."
      }
    }
  }
}

3. Claude Desktop을 재시작하세요. 도구 선택기에서 create_intent, create_escrow, get_balance, negotiate_price와 같은 도구를 확인할 수 있습니다.

퀵스타트 — Cursor / Claude Code / Windsurf

Claude Desktop과 동일합니다. MCP를 지원하는 모든 IDE에서 동일한 설정을 사용할 수 있습니다. 이 서버는 stdio(기본값) 및 Streamable HTTP 전송을 모두 지원합니다.

환경 변수

작동 원리

• 도구 탐색: GET /v1/pricing은 JSON 스키마가 포함된 전체 카탈로그를 반환하며, 이 패키지는 해당 항목들을 MCP Tool 객체로 변환합니다.

• 도구 호출: 각 tools/call은 단일 항목 POST /v1/batch로 전달되며, 이는 다시 게이트웨이 내부의 TOOL_REGISTRY로 전달됩니다.

• 에이전트-SEO: 가격 및 티어 메타데이터가 모든 도구 설명에 포함되어 있어, 플래너 LLM이 가장 저렴하거나 낮은 티어의 대안을 선택할 수 있습니다.

자체 호스팅

docker run --rm -it \
  -e A2A_API_KEY=a2a_pro_... \
  -e A2A_BASE_URL=https://api.greenhelix.net \
  greenhelix/a2a-greenhelix-mcp-server:latest

또는 직접 구축한 게이트웨이를 지정하세요:

A2A_BASE_URL=https://gateway.internal.example.com a2a-greenhelix-mcp-server

라이선스

MIT. LICENSE를 참조하세요.