OKX MCP Server

Fornece dados de preço de criptomoedas em tempo real da exchange OKX.

GitHub
16
Experimente este MCPPatrocinado

Documentação

Servidor MCP OKX

Um servidor Model Context Protocol que fornece dados de preços de criptomoedas em tempo real da exchange OKX.

Recursos

Este servidor MCP conecta-se à API da OKX para fornecer informações de preços de criptomoedas por meio de uma interface de ferramenta simples. Inclui tratamento abrangente de erros, registro de solicitações e limitação de taxa via API da OKX.

Ferramentas

get_candlesticks

Recupera dados históricos de candlestick (OHLCV) para qualquer instrumento na OKX.

  • Entrada:
    • instrument: String (obrigatório) - ID do instrumento (ex.: "BTC-USDT")
    • bar: String (opcional) - Intervalo de tempo (ex.: "1m", "5m", "1H", "1D"), padrão "1m"
    • limit: Número (opcional) - Número de candlesticks a retornar (máx. 100), padrão 100
  • Saída: Matriz de objetos JSON, cada um contendo:
    • timestamp: Carimbo de data/hora ISO do candlestick
    • open: Preço de abertura
    • high: Preço mais alto
    • low: Preço mais baixo
    • close: Preço de fechamento
    • volume: Volume de negociação
    • volumeCurrency: Volume em termos de moeda

Exemplo 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

Busca o preço mais recente e dados de mercado de 24 horas para qualquer instrumento na OKX.

  • Entrada:
    • instrument: String (obrigatório) - ID do instrumento (ex.: "BTC-USDT")
  • Saída: Objeto JSON contendo:
    • instrument: O ID do instrumento solicitado
    • lastPrice: Preço da negociação mais recente
    • bid: Melhor preço de compra atual
    • ask: Melhor preço de venda atual
    • high24h: Preço mais alto em 24 horas
    • low24h: Preço mais baixo em 24 horas
    • volume24h: Volume de negociação em 24 horas
    • timestamp: Carimbo de data/hora ISO dos dados

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

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Instalação

Para usar com Claude Desktop ou VSCode, adicione a configuração do servidor às suas configurações 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

Configuração:

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

Tratamento de Erros

O servidor implementa tratamento abrangente de erros:

  • Erros de rede são capturados e retornados com contexto
  • IDs de instrumento inválidos retornam mensagens de erro apropriadas
  • Limites de taxa da API são respeitados por meio da configuração de tempo limite do axios
  • Todos os erros são registrados para fins de depuração