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: OKX MCP Server

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.