bybit-mcp

Отдельный проект под Bybit API и MCP server.

Что зафиксировано по официальной документации Bybit:

• Базовая документация: https://bybit-exchange.github.io/docs/v5/intro

• Integration/Auth guide: https://bybit-exchange.github.io/docs/v5/guide

• В docs прямо указаны SDK:

  • Official Python SDK: pybit

  • Community Node.js SDK: bybit-api

• Для bot-layer отдельно подтвержден endpoint Futures Grid detail: POST /v5/fgridbot/detail

Почему так:

• Для Hermes/MCP stdio интеграции Node-стек быстрее поднимается и проще тестируется локально.

• bybit-api покрывает стандартный V5 REST, а bot-layer добран прямым signed POST по официальной docs.

Что дополнительно зафиксировано по runtime watcher:

• пути runtime/env централизованы в src/paths.ts

• watcher и scripts больше не размазывают абсолютные runtime path по нескольким файлам

• snapshot active-orders больше не прибит к BTCUSDT; symbol берётся из fgridbot/detail

• текущий operational baseline watcher: grid-risk-watcher.service + Hermes cron bybit-grid-risk-delivery

• есть operator analytics scripts:

  • scripts/alert_stats.ts

  • scripts/risk_metrics_stats.ts

• controlled redelivery workflow протестирован успешно (pause cron → rewind state → replay → restore → resume)

Текущие MCP tools:

• bybit_server_time

• bybit_instruments_info

• bybit_kline

• bybit_wallet_balance

• bybit_positions

• bybit_closed_pnl

• bybit_order_history

• bybit_active_orders

• bybit_execution_history

• bybit_strategy_list

• bybit_strategy_order_list

• bybit_trade_stats

• bybit_futures_grid_detail

• bybit_futures_grid_analysis

• bybit_futures_grid_validate

• bybit_futures_grid_close

• bybit_place_order

• bybit_cancel_order

• bybit_amend_order

Безопасность write-операций:

• приватные write tools требуют BYBIT_API_KEY и BYBIT_API_SECRET

• mainnet write-операции дополнительно требуют BYBIT_WRITE_CONFIRMED=1

• для testnet достаточно BYBIT_ENV=testnet

Запуск:

cd /home/peakviker/bybit-mcp
npm install
npm run build
node dist/index.js

Через wrapper:

/home/peakviker/bybit-mcp/run-mcp.sh

Для Hermes как MCP server:

hermes mcp add bybit-mcp --command /home/peakviker/bybit-mcp/run-mcp.sh
hermes mcp test bybit-mcp