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