OKX MCP Server

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.

Integrations

  • Provides real-time cryptocurrency price data from the OKX exchange, offering tools to retrieve latest prices and historical candlestick (OHLCV) data for any instrument traded on OKX.

Servidor MCP OKX

Un servidor de protocolo de contexto modelo que proporciona datos de precios de criptomonedas en tiempo real del intercambio OKX.

Características

Este servidor MCP se conecta a la API de OKX para proporcionar información sobre el precio de las criptomonedas mediante una sencilla interfaz. Incluye gestión integral de errores, registro de solicitudes y limitación de velocidad mediante la API de OKX.

Herramientas

get_candlesticks

Recupera datos históricos de velas (OHLCV) para cualquier instrumento en OKX.

  • Aporte :
    • instrument : Cadena (obligatoria) - ID del instrumento (p. ej., "BTC-USDT")
    • bar : Cadena (opcional) - Intervalo de tiempo (por ejemplo, "1m", "5m", "1H", "1D"), predeterminado "1m"
    • limit : Número (opcional) - Número de velas a devolver (máximo 100), predeterminado 100
  • Salida : Matriz de objetos JSON, cada uno de los cuales contiene:
    • timestamp : marca de tiempo ISO de la vela
    • open : Precio de apertura
    • high : precio más alto
    • low : precio más bajo
    • close : Precio de cierre
    • volume : Volumen de negociación
    • volumeCurrency : Volumen en términos monetarios

Ejemplo de uso:

[ { "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

Obtiene el último precio y datos del mercado de 24 horas para cualquier instrumento en OKX.

  • Aporte :
    • instrument : Cadena (obligatoria) - ID del instrumento (p. ej., "BTC-USDT")
  • Salida : objeto JSON que contiene:
    • instrument : El ID del instrumento solicitado
    • lastPrice : Último precio de transacción
    • bid : mejor precio de oferta actual
    • ask : Mejor precio de venta actual
    • high24h : precio máximo de 24 horas
    • low24h : precio bajo las 24 horas
    • volume24h : volumen de negociación de 24 horas
    • timestamp : marca de tiempo ISO de los datos

Ejemplo de uso:

{ "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" }

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para usar con Claude Desktop o VSCode, agregue la configuración del servidor a la configuración de 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

Ventanas (VSCode):

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

Windows (Escritorio Claude):

%APPDATA%/Claude/claude_desktop_config.json

Configuración:

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

Manejo de errores

El servidor implementa un manejo integral de errores:

  • Los errores de red se capturan y se devuelven con contexto.
  • Los ID de instrumentos no válidos devuelven mensajes de error apropiados
  • Los límites de velocidad de la API se respetan a través de la configuración del tiempo de espera de Axios
  • Todos los errores se registran con fines de depuración.

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Proporciona datos de precios de criptomonedas en tiempo real del intercambio OKX a través de una interfaz de Protocolo de Contexto de Modelo, lo que permite el acceso a datos históricos de velas y precios de mercado actuales para cualquier instrumento comercial.

  1. Features
    1. Tools
  2. Development
    1. Installation
      1. Error Handling
    ID: glaohtlnse