OKX MCP 服务器

一个提供实时加密货币价格数据的 Model Context Protocol（MCP）服务器，从 OKX 交易所获取数据。

特性

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

工具

get_candlesticks

检索任何 OKX 器械的历史蜡烛图（OHLCV）数据。

• 输入:
  • instrument: String (必填) - 器械 ID (例如 "BTC-USDT")
  • bar: String (可选) - 时间间隔 (例如 "1m", "5m", "1H", "1D")，默认为 "1m"
  • limit: Number (可选) - 返回的蜡烛图数量 (最大值 100)，默认 100
• 输出: 包含以下字段的 JSON 对象数组：
  • timestamp: 烛台的 ISO 时间戳
  • open: 开盘价
  • high: 最高价
  • low: 最低价
  • close: 收盘价
  • volume: 交易量
  • volumeCurrency: 以货币表示的交易量

示例用法：

[
  {
    "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: String (必填) - 器械 ID (例如 "BTC-USDT")
• 输出: 包含以下字段的 JSON 对象：
  • instrument: 请求的器械 ID
  • lastPrice: 最新交易价格
  • bid: 当前最佳买入价
  • ask: 当前最佳卖出价
  • high24h: 24 小时最高价
  • low24h: 24 小时最低价
  • volume24h: 24 小时交易量
  • timestamp: 数据的 ISO 时间戳

示例用法：

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

开发

安装依赖：

npm install

构建服务器：

npm run build

带有自动重建的开发：

npm run watch

安装

与 Claude Desktop 或 VSCode 一起使用时，请将服务器配置添加到 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

配置：

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

错误处理

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

• 捕获网络错误并带上下文返回
• 无效的器械 ID 返回错误
• 默认情况下，所有响应带有 code 和 message 字段