0xAuto OKX MCP Server

此服务器基于模型上下文协议（MCP），提供OKX V5 API和OKX DEX API的工具接口层，使AI代理能够简化访问OKX中心化交易所（CEX）和去中心化交易所（DEX）的功能。

功能

CEX（中心化交易所）功能

• 隐藏复杂的OKX API认证和签名逻辑
• 提供标准的MCP工具接口
• 包含核心功能：
  • 账户信息（余额、持仓、历史）
  • 市场数据（报价、K线）
  • 交易操作（下单、撤单、订单管理）
  • 资金操作（存款地址、提现）

DEX（去中心化交易所）功能

• 提供访问OKX DEX聚合器

• 支持多链交易和代币交换

• 包含功能：

  • 代币报价检索
  • 代币价格查询和K线数据
  • 链上余额查询
  • 代币授权操作
  • 链内和跨链互换

• 标准化的JSON响应和错误处理

• 支持MCP协议会话管理和流式传输

系统需求

• Node.js（v16或更高版本）
• pnpm

安装步骤

1. 安装依赖项：

   pnpm install
   

2. 设置环境变量： 复制.env.example的内容创建一个.env文件：

   cp .env.example .env
   

   编辑.env文件并填写您的OKX API凭证和其他设置：

   # OKX API配置
   OKX_API_KEY=your_okx_api_key
   OKX_SECRET_KEY=your_okx_secret_key
   OKX_PASSPHRASE=your_okx_api_password
   OKX_API_BASE_URL=https://www.okx.com
   OKX_DEX_API_BASE=https://web3.okx.com/api/v5/dex
   
   # 模拟交易：0表示真实交易，1表示模拟账户
   SIMULATED_TRADING=0
   
   SERVER_PORT=3000
   LOG_LEVEL=info
   

   重要提示： 确保您的OKX API密钥具有必要的权限（读取、交易）。

运行服务器

pnpm start
# 或开发模式
pnpm dev

服务器将在指定的SERVER_PORT端口启动（默认3000）。

MCP工具列表

服务器实现了以下MCP工具：

CEX（中心化交易所）工具

账户相关工具

• okx_get_account_info - 获取账户信息
• okx_get_positions - 获取持仓信息
• okx_get_balance - 获取账户余额

交易相关工具

• okx_place_order - 下单
• okx_cancel_order - 撤销订单
• okx_get_orders - 获取订单信息
• okx_get_order_history - 获取历史订单

市场数据工具

• okx_get_ticker - 获取市场报价
• okx_get_kline - 获取K线数据
• okx_get_instruments - 获取产品列表

资金相关工具

• okx_get_deposit_address - 获取存款地址
• okx_get_deposit_history - 获取存款记录
• okx_withdraw - 提现

DEX（去中心化交易所）工具

报价和市场数据

• okx_get_quote - 获取OKX DEX聚合器报价（支持滑点设置）
• okx_get_supported_chains - 获取OKX DEX支持的链
• okx_get_token_list - 获取OKX DEX支持的代币列表
• okx_get_price - 获取OKX DEX上代币的最新价格
• okx_get_kline - 获取OKX DEX上代币的K线数据（支持不同时间粒度）

交易相关工具

• okx_approve_transaction - 获取OKX DEX授权交易信息
• okx_swap - 启动OKX DEX互换
• okx_cross_chain_swap - 启动OKX DDEX跨链互换

余额查询

• okx_get_balance - 获取指定链上钱包地址的所有代币余额

项目结构

src/
├── app.js              # Express应用程序配置
├── index.js            # 服务器启动入口
├── server.js           # MCP服务器创建和工具注册
├── config/             # 配置文件
├── controllers/        # 控制器逻辑
├── middleware/         # 中间件
├── services/           # 服务层
│   ├── okxService.js   # OKX CEX API服务
│   └── okxDexService.js# OKX DEX API服务
├── tools/              # MCP工具实现
│   ├── accountTools.js # CEX账户工具
│   ├── fundingTools.js # CEX资金工具
│   ├── marketTools.js  # CEX市场工具
│   ├── tradeTools.js   # CEX交易工具
│   ├── dexTools.js     # DEX工具注册
│   └── dex/            # DEX工具文件
│       ├── quoteTool.js         # 报价工具
│       ├── supportedChainsTool.js# 支持的链工具
│       ├── tokenListTool.js     # 代币列表工具
│       ├── priceTool.js         # 价格工具
│       ├── klineTool.js         # K线工具
│       ├── balanceTool.js       # 余额工具
│       ├── approveTool.js       # 授权工具
│       ├── swapTool.js          # 互换工具
│       └── crossChainSwapTool.js# 跨链互换工具
└── utils/              # 工具函数

MCP客户端连接

MCP客户端可以通过以下端点与服务器通信：

• /mcp - 主MCP请求端点
• /sse - 向后兼容的SSE端点
• /messages - 向后兼容的消息端点

使用标准的MCP会话管理，包括会话ID和初始化请求。