MCP-сервер Bybit

Сервер протокола контекста модели (MCP) , который обеспечивает доступ только для чтения к API криптовалютной биржи Bybit.

ЭТО ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ КАЧЕСТВА АЛЬФА - ИСПОЛЬЗУЙТЕ НА СВОЙ СТРАХ И РИСК!

Используйте только ключ API только для чтения с этим сервером. Я бы не доверил свой код вашим «деньгам», и вам тоже не стоит!

Функции

Этот MCP-сервер предоставляет следующие инструменты для взаимодействия с API Bybit:

get_ticker : Получить информацию о тикере в реальном времени для торговой пары
get_orderbook : Получить данные книги ордеров (глубины рынка) для торговой пары
get_kline : Получить данные kline/японских свечей для торговой пары
get_market_info : Получить подробную рыночную информацию для торговых пар
get_trades : Получить последние сделки для торговой пары
get_instrument_info : Получить подробную информацию об инструменте для определенной торговой пары
get_wallet_balance : Получить информацию о балансе кошелька для аутентифицированного пользователя
get_positions : Получить информацию о текущих позициях аутентифицированного пользователя
get_order_history : Получить историю заказов для аутентифицированного пользователя
get_ml_rsi : Получить RSI (индекс относительной силы) на основе машинного обучения для торговой пары
get_market_structure : Получить информацию о структуре рынка для торговой пары
get_order_blocks : Обнаружение зон накопления институциональных заказов
get_order_history : Получить историю заказов для аутентифицированного пользователя
get_orderbook : Получить данные книги ордеров (глубины рынка) для торговой пары
get_ticker : Получить информацию о тикере в реальном времени для торговой пары

Также имеется весьма экспериментальный WebUI, подробности см. в файле WebUI README .

Скриншот веб-интерфейса

Весь код может быть подвергнут критическим изменениям и добавлениям/удалениям функций по мере продолжения разработки этого проекта.

Related MCP server: Coin MCP Server

Требования и установка

Node.js (v22+)
пнпм ( npm i -g pnpm )
Если вы хотите запустить клиент Ollama, как показано в кратком руководстве ниже, вам понадобится установленная и запущенная Ollama, а также выбранная вами модель.

pnpm i

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

Для установки пакетов соберите все и запустите интерактивный клиент:

pnpm i

Скопируйте файл .env.example в .env и заполните свои данные.

cp .env.example .env
code .env

MCP-сервер (только)

Stdio-транспорт (по умолчанию)

pnpm serve

HTTP/SSE-транспорт

pnpm start:http

HTTP-сервер по умолчанию работает на порту 8080 и предоставляет как современный Streamable HTTP, так и устаревшие транспорты SSE, что делает его совместимым с веб-приложениями и различными клиентами MCP. Подробную информацию см. в документации HTTP-сервера .

MCP-сервер и клиент Ollama

Установите необходимые клиентские пакеты:

(cd client && pnpm i)

Скопируйте клиентский файл .env.example в .env и заполните свои данные.

cp client/.env.example client/.env
code client/.env

Затем, чтобы запустить клиент и сервер одной командой:

pnpm start

Конфигурация

Переменные среды

Сервер требует, чтобы учетные данные API Bybit были установлены в качестве переменных среды:

BYBIT_API_KEY : Ваш ключ API Bybit (обязательно)
BYBIT_API_SECRET : Ваш секретный ключ API Bybit (обязательно) — ВАЖНО — Создавайте только ключ API, доступный только для чтения!
BYBIT_USE_TESTNET : установите значение «true», чтобы использовать тестовую сеть вместо основной сети (необязательно, по умолчанию — false)
DEBUG : установите значение «true», чтобы включить ведение журнала отладки (необязательно, по умолчанию — false)

Переменные среды клиента (./client/.env):

OLLAMA_HOST : Хост сервера Ollama (по умолчанию http://localhost:11434 )
DEFAULT_MODEL : модель по умолчанию для использования в чате (по умолчанию qwen3-30b-a3b-ud-nothink-128k:q4_k_xl)

Конфигурация настроек MCP

Чтобы использовать этот сервер с клиентами MCP, вам необходимо добавить его в файл конфигурации настроек MCP. Расположение файла зависит от вашего клиента:

Пример MCP - Клод Десктоп

Расположение: ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bybit": {
      "command": "node",
      "args": ["/path/to/bybit-mcp/build/index.js"],
      "env": {
        "BYBIT_API_KEY": "your-api-key",
        "BYBIT_API_SECRET": "your-api-secret",
        "BYBIT_USE_TESTNET": "false"
      }
    }
  }
}

Пример MCP - gomcp

Расположение: ~/.config/gomcp/config.yaml

mcp_servers:
  - name: "bybit"
    command: "cd /path/to/bybit-mcp && pnpm run serve"
    arguments: []
    env:
      BYBIT_API_KEY: ""      # Add your Bybit API **READ ONLY** key here
      BYBIT_API_SECRET: ""   # Add your Bybit API **READ ONLY** secret here
      BYBIT_USE_TESTNET: "true"  # Set to false for production
      DEBUG: "false"         # Optional: Set to true for debug logging

Интеграция клиента

Этот пакет включает клиент TypeScript, который предоставляет интерфейс командной строки для взаимодействия как с Ollama LLM, так и с сервером bybit-mcp. Клиент поддерживает:

Интерактивный чат с моделями Ollama
Прямой доступ ко всем торговым инструментам bybit-mcp
Автоматическое управление сервером
Конфигурация на основе среды
Отладочное ведение журнала

Подробную документацию по клиенту см. в файле README клиента .

Запуск сервера

Производство

Сборка сервера:

pnpm build

Запустите сервер:

node build/index.js

Разработка

Для разработки с автоматической перекомпиляцией TypeScript:

pnpm watch

Чтобы проверить сервер MCP во время разработки:

pnpm inspector

Документация по инструменту

Получить информацию о тикере

{
  "name": "get_ticker",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot" // optional, defaults to "spot"
  }
}

Получить данные книги заказов

{
  "name": "get_orderbook",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "limit": 25 // optional, defaults to 25 (available: 1, 25, 50, 100, 200)
  }
}

Получить данные Клайна/японских свечей

{
  "name": "get_kline",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "interval": "1", // optional, defaults to "1" (available: "1", "3", "5", "15", "30", "60", "120", "240", "360", "720", "D", "M", "W")
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

Получить информацию о рынке

{
  "name": "get_market_info",
  "arguments": {
    "category": "spot", // optional, defaults to "spot"
    "symbol": "BTCUSDT", // optional, if not provided returns info for all symbols in the category
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

Получить последние сделки

{
  "name": "get_trades",
  "arguments": {
    "symbol": "BTCUSDT",
    "category": "spot", // optional, defaults to "spot"
    "limit": 200 // optional, defaults to 200 (max 1000)
  }
}

Получить информацию об инструменте

{
  "name": "get_instrument_info",
  "arguments": {
    "symbol": "BTCUSDT", // required
    "category": "spot" // optional, defaults to "spot"
  }
}

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

Базовая и котируемая валюты
Торговый статус
Фильтры размера партии (мин./макс. количество заказа)
Фильтры цен (размер тика)
Настройки кредитного плеча (для фьючерсов)
Детали контракта (для фьючерсов)

Получить баланс кошелька

{
  "name": "get_wallet_balance",
  "arguments": {
    "accountType": "UNIFIED", // required (available: "UNIFIED", "CONTRACT", "SPOT")
    "coin": "BTC" // optional, if not provided returns all coins
  }
}

Получить позиции

{
  "name": "get_positions",
  "arguments": {
    "category": "linear", // required (available: "linear", "inverse")
    "symbol": "BTCUSDT", // optional
    "baseCoin": "BTC", // optional
    "settleCoin": "USDT", // optional
    "limit": 200 // optional, defaults to 200
  }
}

Получить историю заказов

{
  "name": "get_order_history",
  "arguments": {
    "category": "spot", // required (available: "spot", "linear", "inverse")
    "symbol": "BTCUSDT", // optional
    "baseCoin": "BTC", // optional
    "orderId": "1234567890", // optional
    "orderLinkId": "myCustomId", // optional
    "orderStatus": "Filled", // optional (available: "Created", "New", "Rejected", "PartiallyFilled", "PartiallyFilledCanceled", "Filled", "Cancelled", "Untriggered", "Triggered", "Deactivated")
    "orderFilter": "Order", // optional (available: "Order", "StopOrder")
    "limit": 200 // optional, defaults to 200
  }
}

Поддерживаемые категории

spot : спотовая торговля
linear : Линейные бессрочные контракты
inverse : обратные бессрочные контракты

Лицензия

Массачусетский технологический институт

Bybit MCP Server