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