a2a-greenhelix-mcp-server

エージェントコマース用MCPサーバー。 Green Helix A2A Commerce Gateway から、請求、決済、エスクロー、ID、マーケットプレイス、信頼、メッセージングなど、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（デフォルト）とストリーミング可能な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 を参照してください。