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

Related MCP server: Crypto MCP

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.