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 .

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

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

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

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

Лицензия

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Сервер Model Context Protocol, который обеспечивает доступ только для чтения к API криптовалютной биржи Bybit, позволяя пользователям запрашивать данные о криптовалютах в режиме реального времени, используя естественный язык.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Coin MCP Server
longmans
A
security
F
license
A
quality
A Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data, enabling AI applications to retrieve cryptocurrency listings, quotes, and detailed information.
Last updated -
3
10
Python
Binance MCP Server
tienan92it
-
security
A
license
-
quality
A Model Context Protocol server that exposes Binance cryptocurrency exchange data to LLMs, allowing agents to access real-time prices, order books, and historical market data without requiring API keys.
Last updated -
4
Python
MIT License
Realtime Crypto MCP Server
smhnkmr
-
security
-
license
-
quality
A server that provides real-time cryptocurrency data through the Model Context Protocol, allowing access to detailed exchange information and current cryptocurrency rates from the CoinCap API.
Last updated -
1
TypeScript
MIT License
Satstream MCP Serverofficial
satstream
A
security
A
license
A
quality
A Model Context Protocol server that enables querying Bitcoin blockchain data, including address information, transaction details, mempool statistics, and ordinals/runes data through the Satstream API.
Last updated -
37
TypeScript
MIT License

View all related MCP servers

Bybit MCP Server