OKX MCP Server

Proporciona datos de precios de criptomonedas en tiempo real desde el exchange OKX.

GitHub
16
Prueba este MCPPatrocinado

Documentación

OKX MCP Server

Un servidor de Model Context Protocol que proporciona datos de precios de criptomonedas en tiempo real del exchange OKX.

Características

Este servidor MCP se conecta a la API de OKX para proporcionar información de precios de criptomonedas a través de una interfaz de herramientas simple. Incluye manejo integral de errores, registro de solicitudes y limitación de velocidad a través de la API de OKX.

Herramientas

get_candlesticks

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

  • Entrada:
    • instrument: String (obligatorio) - ID del instrumento (p. ej. "BTC-USDT")
    • bar: String (opcional) - Intervalo de tiempo (p. ej. "1m", "5m", "1H", "1D"), por defecto "1m"
    • limit: Number (opcional) - Número de velas a devolver (máx. 100), por defecto 100
  • Salida: Array de objetos JSON, cada uno con:
    • 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 de moneda

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 los datos de mercado de 24 horas para cualquier instrumento en OKX.

  • Entrada:
    • instrument: String (obligatorio) - ID del instrumento (p. ej. "BTC-USDT")
  • Salida: Objeto JSON que contiene:
    • instrument: El ID del instrumento solicitado
    • lastPrice: Último precio de negociación
    • bid: Mejor precio de oferta actual
    • ask: Mejor precio de demanda actual
    • high24h: Precio máximo de 24 horas
    • low24h: Precio mínimo de 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

Compilar el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para usar con Claude Desktop o VSCode, añade la configuración del servidor a tus ajustes 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

Windows (VSCode):

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

Windows (Claude Desktop):

%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 IDs de instrumento no válidos devuelven mensajes de error apropiados
  • Los límites de velocidad de la API se respetan mediante la configuración de tiempo de espera de axios
  • Todos los errores se registran con fines de depuración