项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，它利用强大的 CCXT 库与全球众多加密货币交易所进行交互。通过将 CCXT 库的功能封装成 MCP 工具，本项目使得大型语言模型 (LLMs) 或其他 MCP 客户端能够以标准化的方式访问交易所数据（如市场行情、历史数据）和执行账户操作（如查询余额、下订单、提币）。

主要功能点

• 账户与交易管理 (需API认证):

  • 查询账户余额
  • 获取充币地址
  • 发起提币请求
  • 查询未平仓合约 (期货/衍生品)
  • 设置交易杠杆 (期货)
  • 创建现货限价/市价订单
  • 创建期货限价/市价订单
  • 取消现有订单
  • 查询历史订单记录
  • 查询个人交易记录

• 市场数据查询 (通常无需API认证):

  • 获取历史 OHLCV (K线) 数据
  • 查询永续合约资金费率
  • 获取市场深度数据 (未在代码中明确列出，但CCXT支持，可能通过通用参数调用)
  • 获取期权合约数据
  • 查询最新市场行情 (Ticker)
  • 获取近期公共交易记录

所有工具都提供了清晰的参数描述，方便 LLM 理解和调用。

安装步骤

1. 克隆仓库: 如果您有仓库地址，请使用 Git 克隆：

   git clone <仓库地址>
   cd ccxt-mcp-server
   

   或者直接下载代码压缩包并解压。

2. 创建并激活虚拟环境 (推荐):

   python -m venv .venv
   # 在 macOS/Linux 上激活
   source .venv/bin/activate
   # 在 Windows 上激活
   .venv\Scripts\activate
   

3. 安装依赖: 进入项目目录，使用 pip 或 uv 安装 'requirements.txt' 中列出的依赖：

   pip install -r requirements.txt
   # 或者使用 uv (如果已安装)
   uv pip install -r requirements.txt
   

服务器配置

MCP 客户端需要知道如何启动并连接到此服务器。您需要将以下配置信息提供给您的 MCP 客户端。其中 'command' 是启动服务器的命令，'args' 是传递给命令的参数。

{
  "serverName": "CCXT MCP Server",
  "command": "python",
  "args": ["path/to/your/ccxt-mcp-server/mcp_server.py"]
  // 注意：请将 "path/to/your/ccxt-mcp-server" 替换为您实际克隆或解压项目代码的路径
  // MCP客户端通常会根据需要自动处理协议（Stdio、WebSocket等）和连接方式。
}

基本使用方法

1. 启动服务器: 在您的终端中，激活虚拟环境后，运行项目主文件：

   python mcp_server.py
   

   服务器启动后会显示相应的日志信息。

2. 连接与工具调用: 使用支持 MCP 协议的 LLM 客户端连接到此服务器。客户端将能够发现服务器提供的所有工具（如 'fetch_account_balance', 'fetch_ohlcv', 'create_spot_limit_order' 等）。 LLM 客户端可以通过调用这些工具，并根据工具描述提供相应的参数（如 'exchange_id', 'symbol', 'api_key', 'secret_key', 'amount', 'price', 'timeframe' 等），来获取加密货币数据或执行交易操作。需要 API 认证的工具必须提供有效的 'api_key' 和 'secret_key'。