buda-mcp

MCP-сервер для Buda.com — ведущей криптовалютной биржи в Чили, Колумбии и Перу. Предоставляет любому MCP-совместимому ИИ-ассистенту доступ в реальном времени к рыночным данным, биржевым стаканам, истории торгов, спредам, техническим индикаторам и симуляции цен — учетная запись или API-ключ не требуются.

Быстрый старт

npx @guiie/buda-mcp

Или установите постоянно:

npm install -g @guiie/buda-mcp
buda-mcp

Установка в ваш MCP-клиент

Claude Code

claude mcp add buda-mcp -- npx -y @guiie/buda-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "buda-mcp": {
      "command": "npx",
      "args": ["-y", "@guiie/buda-mcp"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "buda-mcp": {
      "command": "npx",
      "args": ["-y", "@guiie/buda-mcp"]
    }
  }
}

Инструменты

Все инструменты общедоступны — API-ключ или учетная запись не требуются.

get_market_summary ⭐ Начните отсюда

Сводка по одному запросу: последняя цена, bid/ask, спред в %, объем за 24 часа, изменение цены и liquidity_rating (high / medium / low). Лучший инструмент для начала, когда пользователь спрашивает о конкретном рынке.

get_markets

Список всех торговых пар на Buda.com или получение подробной информации по конкретному рынку (комиссии, минимальный размер ордера, уровни скидок).

get_ticker

Текущий снимок: последняя цена, лучший bid/ask, объем за 24 часа и изменение цены за 24 часа и 7 дней.

get_orderbook

Текущий биржевой стакан: отсортированные заявки на покупку и продажу в виде объектов {price, amount}.

get_trades

История недавних сделок в виде типизированных объектов: {timestamp_ms, amount, price, direction}.

get_market_volume

Объем торгов за 24 часа и 7 дней по сторонам (bid = покупки, ask = продажи).

get_spread

Спред bid/ask: абсолютное значение и процент от цены ask.

compare_markets

Сравнение данных тикера для всех пар с заданной базовой валютой по всем котируемым валютам.

get_price_history

Свечи OHLCV, агрегированные из истории сделок (у Buda нет встроенного эндпоинта для свечей). Поддерживаются периоды 5m, 15m, 30m, 1h, 4h, 1d.

get_arbitrage_opportunities

Обнаруживает расхождения цен между странами для актива на рынках CLP, COP и PEN, нормализованных к USDC.

simulate_order

Симулирует ордер на покупку или продажу, используя актуальные данные тикера — ордер не размещается. Возвращает estimated_fill_price, fee_amount, total_cost, slippage_vs_mid_pct. Все ответы включают simulation: true.

calculate_position_size

Расчет размера позиции по методу Келли на основе капитала, % риска, цены входа и стоп-лосса. Полностью на стороне клиента — без вызова API.

get_market_sentiment

Составной показатель настроений (от -100 до +100) из трех компонентов: изменение цены за 24 часа (40%), объем относительно среднего за 7 дней (35%), спред относительно базового уровня рынка (25%). Возвращает score, label, component_breakdown и disclaimer.

get_technical_indicators

RSI (14), MACD (12/26/9), Полосы Боллинджера (20, 2σ), SMA 20, SMA 50 — вычисляются на стороне сервера из истории сделок Buda (без внешних библиотек). Возвращает интерпретацию сигналов и структурированное предупреждение, если доступно менее 20 свечей. Включает disclaimer.

get_real_quotation

Возвращает котировку в реальном времени для заданного размера ордера и направления, показывая точную цену исполнения, комиссию и изменения баланса без размещения ордера.

get_available_banks

Список доступных банков для фиатных депозитов/выводов в стране соответствующей валюты.

MCP-ресурсы

Помимо инструментов, сервер предоставляет MCP-ресурсы, которые клиенты могут читать напрямую:

Охваченные рынки

Сборка из исходного кода

git clone https://github.com/gtorreal/buda-mcp.git
cd buda-mcp
npm install
npm run build
node dist/index.js        # stdio (for MCP clients)
node dist/http.js         # HTTP on port 3000 (for Railway / hosted)

Запуск тестов:

npm run test:unit        # 100 unit tests, no network required
npm run test:integration # live API tests (skips if unreachable)
npm test                 # both

HTTP / Развертывание в Railway

Точка входа dist/http.js запускает Express-сервер с:

• POST /mcp — потоковый HTTP-транспорт MCP

• GET /mcp — потоковый транспорт SSE

• GET /health — проверка работоспособности ({ status })

• GET /.well-known/mcp/server-card.json — статический манифест инструментов, совместимый со Smithery

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

Безопасность

Сервер предоставляет доступ только к публичным API-эндпоинтам Buda.com. Учетные данные не принимаются и не сохраняются. Валидация входных данных применяется ко всем параметрам инструментов для предотвращения инъекций промптов. Сообщения об ошибках очищены — внутренние детали (пути, ошибки вышестоящих систем) записываются только в stderr и никогда не возвращаются вызывающим сторонам.

Сообщение об уязвимостях

Пожалуйста, сообщайте о проблемах безопасности в частном порядке через GitHub Security Advisories — не как публичные issues. См. SECURITY.md для полной политики раскрытия информации.

Структура проекта

src/
  client.ts                   BudaClient (HTTP + 429 retry)
  cache.ts                    In-memory TTL cache with in-flight deduplication
  types.ts                    TypeScript types for Buda API responses
  validation.ts               validateMarketId(), validateCurrency()
  utils.ts                    flattenAmount(), aggregateTradesToCandles(), getLiquidityRating()
  version.ts                  Single source of truth for version string
  index.ts                    stdio MCP server entrypoint
  http.ts                     HTTP/SSE MCP server entrypoint
  tools/
    markets.ts                get_markets
    ticker.ts                 get_ticker
    orderbook.ts              get_orderbook
    trades.ts                 get_trades
    volume.ts                 get_market_volume
    spread.ts                 get_spread
    compare_markets.ts        compare_markets
    price_history.ts          get_price_history
    arbitrage.ts              get_arbitrage_opportunities
    market_summary.ts         get_market_summary
    simulate_order.ts         simulate_order
    calculate_position_size.ts calculate_position_size
    market_sentiment.ts       get_market_sentiment
    technical_indicators.ts   get_technical_indicators
    banks.ts                  get_available_banks
    quotation.ts              get_real_quotation
marketplace/
  cursor-mcp.json             Cursor MCP config example
  claude-listing.md           Claude registry listing
  openapi.yaml                OpenAPI spec (GPT Actions / HTTP wrapper)
  gemini-tools.json           Gemini function declarations

Лицензия

MIT — Документация API Buda.com