a2a-greenhelix-mcp-server

MCP-сервер для агентской коммерции. Предоставляет 141 инструмент для коммерции — биллинг, платежи, эскроу, идентификация, маркетплейс, доверие, обмен сообщениями — из Green Helix A2A Commerce Gateway для любого агента с поддержкой 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. Получите API-ключ (бесплатный тариф: 500 кредитов / 100 запросов в час) на сайте https://greenhelix.net.

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 — любая IDE с поддержкой MCP принимает ту же конфигурацию. Сервер поддерживает как stdio (по умолчанию), так и потоковый HTTP-транспорт.

Переменные окружения

Как это работает

• Обнаружение инструментов: GET /v1/pricing возвращает полный каталог с JSON-схемами; этот пакет преобразует записи в объекты Tool для MCP.

• Вызов инструментов: каждый tools/call пересылается как одноэлементный POST /v1/batch, который, в свою очередь, отправляется во внутренний TOOL_REGISTRY шлюза.

• Agent-SEO: метаданные о ценах и уровнях включены в описание каждого инструмента, чтобы LLM-планировщики могли выбирать самый дешевый или наиболее подходящий по уровню вариант.

Self-hosting

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.