OKX MCP 服务器

一个提供来自OKX交易所实时加密货币价格数据的模型上下文协议服务器。

特性

此MCP服务器连接到OKX API，通过简单的工具接口提供加密货币价格信息。它包括全面的错误处理、请求日志记录以及通过OKX API进行的速率限制。

工具

get_candlesticks

检索OKX上任何工具的历史K线（OHLCV）数据。

• 输入:
  • instrument: 字符串（必填）- 工具ID（例如 "BTC-USDT"）
  • bar: 字符串（可选）- 时间间隔（例如 "1m", "5m", "1H", "1D"），默认为 "1m"
  • limit: 数字（可选）- 返回的K线条数（最大100条），默认100
• 输出: JSON对象数组，每个包含：
  • timestamp: K线的时间戳
  • open: 开盘价
  • high: 最高价
  • low: 最低价
  • close: 收盘价
  • volume: 成交量
  • volumeCurrency: 成交量（以货币单位表示）

示例用法：

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

获取OKX上任何工具的最新价格和24小时市场数据。

• 输入:
  • instrument: 字符串（必填）- 工具ID（例如 "BTC-USDT"）
• 输出: 包含以下内容的JSON对象：
  • instrument: 请求的工具ID
  • lastPrice: 最新成交价
  • bid: 当前最佳买入价
  • ask: 当前最佳卖出价
  • high24h: 24小时最高价
  • low24h: 24小时最低价
  • volume24h: 24小时成交量
  • timestamp: 数据的时间戳

示例用法：

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

开发

安装依赖项：

bash npm install

构建服务器：

bash npm run build

开发时自动重建：

bash npm run watch

安装

要与Claude Desktop或VSCode一起使用，请将服务器配置添加到您的MCP设置中：

macOS (VSCode):

bash ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

macOS (Claude Desktop):

bash ~/Library/Application Support/Claude/claude_desktop_config.json

Windows (VSCode):

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

Windows (Claude Desktop):

bash %APPDATA%/Claude/claude_desktop_config.json

配置：

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

错误处理

服务器实现了全面的错误处理：

• 捕获并返回带有上下文的网络错误
• 对于无效的工具ID，返回适当的错误消息
• 通过axios超时配置尊重API速率限制
• 所有错误都会被记录以便调试