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: Binance MCP Server

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

1. Node.js (v22+)

2. пнпм ( npm i -g pnpm )

3. Если вы хотите запустить клиент 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 клиента .

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

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

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

pnpm build

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

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 : обратные бессрочные контракты

Лицензия

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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• get_instrument_infoC
• get_klineC
• get_market_infoC
• get_market_structureC
• get_ml_rsiB
• get_order_blocksC
• get_orderbookC
• get_order_historyC