mcp-market-server

MCP (Model Context Protocol) сервер, предоставляющий живые данные крипторынка и бумажный торговый движок в виде стандартизованных вызовов инструментов — так что любой агент (Claude Code, кастомные мультиагентные системы) может запрашивать Bybit и выполнять имитационные сделки.

Разработан для заявки на стажировку Tower Research Capital AI/ML: демонстрирует интеграцию MCP, вызовы инструментов агентом, контроль рисков и продакшн-код на Python.

Архитектура

┌─────────────┐     MCP stdio      ┌──────────────────┐    REST     ┌─────────┐
│ Claude Code │ ◄───────────────► │  FastMCP Server  │ ─────────►  │  Bybit  │
│   / Agent   │                    │  (tools.py)      │  public API │   v5    │
└─────────────┘                    └────────┬─────────┘             └─────────┘
                                            │
                                   ┌────────▼─────────┐
                                   │  Paper Engine    │
                                   │  SQLite + Risk   │
                                   └──────────────────┘

Related MCP server: Data Puller MCP Server

Доступные инструменты

Риск-защита (бумажный движок)

• Максимальный номинал на ордер (risk.max_order_notional_usd)

• Максимум открытых позиций (risk.max_open_positions)

• Остановка по дневному убытку — торговля отключается, когда дневная просадка превышает лимит

• Каждый ордер и решение записываются в таблицу аудит-лога

Настройка

cd mcp-market-server
python -m venv .venv && .venv\Scripts\activate     # Windows
pip install -e ".[dev]"
cp .env.example .env                                # optional overrides
pytest                                              # run tests

Регистрация в Claude Code

{
  "mcpServers": {
    "market": {
      "command": "python",
      "args": ["-m", "mcp_market_server.server"],
      "cwd": "/absolute/path/to/mcp-market-server"
    }
  }
}

Или через командную строку:

claude mcp add market -- python -m mcp_market_server.server

Демо-запросы

Fetch the last 100 hourly candles for BTCUSDT and summarize the trend.

Place a paper long of 0.01 BTCUSDT with a 2% stop loss and take profit at 3%.

Show my account, then flatten everything if unrealized PnL is worse than -$50.

Заметки по дизайну

• Только публичные эндпоинты — без API-ключей и реальных денег. Бумажный движок исполняет рыночные ордера по живой цене биржи, лимитные — при касании цены.

• SQLite для ордеров/позиций/сделок/аудита — персистентность без внешних зависимостей, как в квант-отделах ведётся журнал каждого решения.

• Слой риска между инструментами и движком — та же схема, что и на реальном торговом столе: стратегия предлагает, риск распоряжается.