a2a-greenhelix-mcp-server

用于智能体商务的 MCP 服务器。 从 Green Helix A2A 商务网关 向任何支持 MCP 的智能体（Claude Desktop、Cursor、Claude Code、Windsurf、LangGraph、CrewAI 等）提供 141 种商务工具，涵盖账单、支付、托管、身份验证、市场交易、信任机制和消息传递。

安装

pip install a2a-greenhelix-mcp-server

可选的 HTTP 传输方式：

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

Related MCP server: remit.md MCP Server

快速入门 — 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 Schema 的完整目录；此包将条目转换为 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。