OKX MCP-сервер

Сервер Model Context Protocol, который предоставляет данные о ценах криптовалют в режиме реального времени с биржи OKX.

Функции

Этот сервер MCP подключается к API OKX для предоставления информации о ценах криптовалют через простой интерфейс инструмента. Он включает в себя комплексную обработку ошибок, регистрацию запросов и ограничение скорости через API OKX.

Инструменты

get_candlesticks

Извлекает исторические данные свечей (OHLCV) для любого инструмента на OKX.

• Вход :

  • instrument : Строка (обязательно) - Идентификатор инструмента (например, «BTC-USDT»)

  • bar : Строка (необязательно) — временной интервал (например, «1m», «5m», «1H», «1D»), по умолчанию «1m»

  • limit : Number (необязательно) — количество возвращаемых свечей (макс. 100), по умолчанию 100

• Вывод : Массив объектов JSON, каждый из которых содержит:

  • timestamp : временная метка ISO свечи

  • open : Цена открытия

  • high : Самая высокая цена

  • low : Самая низкая цена

  • close : Цена закрытия

  • volume : Объем торговли

  • volumeCurrency : Объем в валютном выражении

Пример использования:

[
  {
    "timestamp": "2025-03-07T17:00:00.000Z",
    "open": "87242.8",
    "high": "87580.2",
    "low": "86548.0",
    "close": "87191.8",
    "volume": "455.72150427",
    "volumeCurrency": "39661166.242091111"
  }
]

get_price

Получает последние цены и 24-часовые рыночные данные по любому инструменту на OKX.

• Вход :

  • instrument : Строка (обязательно) - Идентификатор инструмента (например, «BTC-USDT»)

• Вывод : объект JSON, содержащий:

  • instrument : запрошенный идентификатор инструмента

  • lastPrice : Последняя цена сделки

  • bid : Текущая лучшая цена предложения

  • ask : Текущая лучшая цена предложения

  • high24h : 24-часовая высокая цена

  • low24h : низкая цена 24 часа в сутки

  • volume24h : объем торговли за 24 часа

  • timestamp : временная метка ISO данных

Пример использования:

{
  "instrument": "BTC-USDT",
  "lastPrice": "65432.1",
  "bid": "65432.0",
  "ask": "65432.2",
  "high24h": "66000.0",
  "low24h": "64000.0",
  "volume24h": "1234.56",
  "timestamp": "2024-03-07T17:22:28.000Z"
}

Related MCP server: OKX MCP Server

Разработка

Установите зависимости:

npm install

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

npm run build

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

npm run watch

Установка

Для использования с Claude Desktop или VSCode добавьте конфигурацию сервера в настройки MCP:

macOS (VSCode):

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

macOS (Claude Desktop):

~/Library/Application Support/Claude/claude_desktop_config.json

Windows (VSCode):

%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Windows (рабочий стол Клода):

%APPDATA%/Claude/claude_desktop_config.json

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

{
  "mcpServers": {
    "okx": {
      "command": "node",
      "args": ["/path/to/okx-mcp-server/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Обработка ошибок

На сервере реализована комплексная обработка ошибок:

• Сетевые ошибки фиксируются и возвращаются с контекстом.

• Недействительные идентификаторы инструментов возвращают соответствующие сообщения об ошибках.

• Ограничения скорости API соблюдаются с помощью конфигурации тайм-аута axios

• Все ошибки регистрируются в целях отладки.