mcpField
O
OKX MCP Server

OKX MCP Server

本地服务
github.com/aahl金融数据250 周前更新

关于 OKX MCP Server

OKX MCP Server 将 OKX 账户与市场数据能力提供给 MCP 客户端,面向需要查询账户、行情或执行交易操作的用户。它包含账户、订单和市场数据工具,并支持 uvx 或 Docker 部署。

主要功能

  1. 01查询账户配置与余额
  2. 02查看持仓及持仓风险
  3. 03提交、取消和查询订单
  4. 04获取加密货币行情

适用场景

  1. 01检查 OKX 账户余额和配置
  2. 02查看持仓及相关风险
  3. 03提交订单或取消未完成订单
  4. 04查询行情排名及订单历史

MCP 相关

该服务向 MCP 客户端公开 OKX 账户、交易及市场数据工具。可通过 uvx 本地启动,或使用 Docker 提供 Streamable HTTP 连接;需要配置 OKX API 凭据。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"aahl-mcp-okx": {
"command": "uvx",
"args": [
"mcp-okx"
]
}
}
}
启动命令uvx mcp-okx

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypimcp-okx0.1.0
ocighcr.io/aahl/mcp-okx:latest

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

🆗 OKX MCP 服务

📲 安装

方法 1:uvx
{
  "mcpServers": {
    "mcp-okx": {
      "command": "uvx",
      "args": ["mcp-okx"],
      "env": {
        "OKX_API_KEY": "your-okx-api-key",
        "OKX_API_SECRET": "api-secret-key",
        "OKX_PASSPHRASE": "api-passphrase",
        "OKX_TRADE_FLAG": "1", # 0: Production trading, 1: Demo trading
        "OKX_BASE_URL": "https://www.okx.com", # Optional
        "MCP_AUTH_TOKEN": "your-custom-token"  # Default same as OKX_API_KEY
      }
    }
  }
}
方法 2:Docker
mkdir /opt/mcp-okx
cd /opt/mcp-okx
wget https://raw.githubusercontent.com/aahl/mcp-okx/refs/heads/main/docker-compose.yml
docker-compose up -d
{
  "mcpServers": {
    "mcp-okx": {
      "url": "http://0.0.0.0:8811/mcp", # Streamable HTTP
      "headers": {
        "Authorization": "Bearer your-okx-api-key-or-custom-token"
      }
    }
  }
}
⚙️ 环境变量
  • OKX_API_KEY:OKX 账户的 API 密钥。有关 API 密钥的创建,请参阅我的 API 页面。
  • OKX_API_SECRET:OKX 账户的 API 密钥。
  • OKX_PASSPHRASE:OKX 账户的 API 口令。
  • OKX_TRADE_FLAG:0:实盘交易,1:模拟交易
  • OKX_BASE_URL:OKX 的基础 URL。默认值:https://www.okx.com
  • MCP_AUTH_TOKEN:用于身份验证的自定义令牌。默认值与 OKX_API_KEY 相同

🛠️ 可用工具

账户工具
  • account_config - 获取账户配置
  • account_balance - 获取账户余额
  • account_positions - 获取账户持仓
  • account_position_risk - 获取账户持仓风险
交易工具
  • place_order - 下新订单
  • cancel_order - 取消未完成的订单
  • get_trade_order - 获取订单详情
  • get_order_list - 获取未完成的订单列表
  • get_orders_history - 获取订单历史
  • close_positions - 平掉所有持仓
市场数据
  • market_tickers - 获取加密货币排行榜

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。