# MCP OKX实时价格工具
## 基本信息
- Slug: `pj-tst-238819-mcp`
- Source: modelscope
- Publisher: @PJ-TST-238819/mcp
- Categories: cryptocurrency / 金融
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@PJ-TST-238819/mcp
## 简介
通过模型上下文协议接口提供来自OKX交易所的实时加密货币价格数据。
## MCP Server 详情

# 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速率限制
- 所有错误都会被记录以便调试