English | 中文

okx-trade-mcp

OKX 的 MCP Server，供 Claude/Cursor 等 AI 工具调用，通过 MCP 协议（stdio） 暴露 OKX 的行情、账户、现货、合约工具。

安装

npm install -g @okx_ai/okx-trade-mcp

配置凭证

创建 ~/.okx/config.toml：

default_profile = "demo"

[profiles.live]
api_key = "your-live-api-key"
secret_key = "your-live-secret-key"
passphrase = "your-live-passphrase"

[profiles.demo]
api_key = "your-demo-api-key"
secret_key = "your-demo-secret-key"
passphrase = "your-demo-passphrase"
demo = true

启动

okx-trade-mcp --profile live         # 指定 profile
okx-trade-mcp --modules market       # 只加载行情（无需 Key）
okx-trade-mcp --read-only            # 只读模式，禁止下单
okx-trade-mcp --modules all          # 加载所有模块

Claude Desktop 配置

在 claude_desktop_config.json 中新增：

{
  "mcpServers": {
    "okx-live": {
      "command": "npx",
      "args": ["-y", "@okx_ai/okx-trade-mcp", "--profile", "live", "--modules", "all"]
    },
    "okx-demo": {
      "command": "npx",
      "args": ["-y", "@okx_ai/okx-trade-mcp", "--profile", "demo"]
    }
  }
}

提示： 运行 okx-trade-mcp setup --client claude-desktop 可自动生成以上配置。

更多说明请参考仓库根目录 README。