CCXT MCP Server

CCXT MCP 服务器

该项目提供了一个模型上下文协议 (MCP) 服务器，它将CCXT库中的各种功能公开为大型语言模型 (LLM) 的工具。

它允许 LLM 以标准化和异步的方式与加密货币交易所进行交互，执行获取余额、市场数据、创建订单等任务。

该服务器使用FastMCP构建，它简化了在 Python 中创建 MCP 服务器的过程。

特征

• CCXT 集成：包装常见的 CCXT 功能以进行交换交互。
• 异步：使用asyncio和ccxt.async_support构建，实现高效的非阻塞操作。
• 清晰的工具定义：使用typing.Annotated和pydantic.Field进行清晰的参数描述和约束，使 LLM（和开发人员）更容易理解和使用这些工具。
• 身份验证处理：支持私有端点的 API 密钥、秘密和密码身份验证。
• 公共和私人工具：为公共市场数据和私人账户操作提供单独的工具。

安装

1. 克隆存储库（如果还没有）：
   git clone https://github.com/jcwleo/ccxt-mcp-server.git cd ccxt-mcp-server
2. 创建并激活虚拟环境（推荐）：
   python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
3. **安装依赖项：**所需的库列在requirements.txt中。您可以使用pip或uv安装它们。
   • 使用pip ：
     pip install -r requirements.txt
   • 使用uv （如果已安装）：
     uv pip install -r requirements.txt # Or, if you prefer uv's environment management: # uv sync

运行服务器

安装依赖项后，您可以直接运行 MCP 服务器：

您应该看到表明服务器已启动的输出，类似于：

然后，MCP 客户端就可以连接该服务器了（通常在 FastMCP 管理的默认端口上，除非另有配置）。

MCP 服务器配置（适用于 MCP 客户端）

如果您正在使用需要手动服务器配置的 MCP 客户端（如 Claude 桌面应用程序），则需要提供类似于以下 JSON 的配置。

创建一个claude_desktop_config.json文件（或 MCP 客户端的等效文件），其结构如下：

重要的：

• 将"/path/to/your/ccxt-mcp-server"替换为您克隆或下载此ccxt-mcp-server项目的目录的实际绝对路径（即包含mcp_server.py的目录）。
• "command"和"args"取决于你如何运行 Python 项目，以及你使用的是uv还是虚拟环境。上面的示例使用的是uv 。
  • 如果您直接使用python虚拟环境，则命令可能如下所示：
    { "mcpServers": { "ccxt-mcp-server": { "command": "/path/to/your/.venv/bin/python", // Or `python.exe` on Windows "args": [ "mcp_server.py" ], "workingDirectory": "/path/to/your/ccxt-mcp-server" } } }
    确保command指向虚拟环境中的 Python 可执行文件，并且workingDirectory设置为项目的根目录。

此配置告诉您的 MCP 客户端如何启动并与 CCXT MCP 服务器通信。

可用的 MCP 工具

该服务器公开以下工具，按是否需要 API 身份验证进行分类。

需要 API 身份验证的工具（私有）

• fetch_account_balance ：获取当前账户余额。
• fetch_deposit_address ：获取货币的存款地址。
• withdraw_cryptocurrency ：将加密货币提取到指定地址。
• fetch_open_positions ：获取未平仓头寸（主要用于期货/衍生品）。
• set_trading_leverage ：设置交易符号的杠杆（主要用于期货）。
• create_spot_limit_order ：下达新的现货限价订单。
• create_spot_market_order ：下达新的现货市场订单。
• create_futures_limit_order ：下达新的期货限价订单。
• create_futures_market_order ：下达新的期货市场订单。
• cancel_order ：取消现有的未结订单。
• fetch_order_history ：获取订单历史记录（开仓/平仓）。
• fetch_my_trade_history ：获取用户执行的交易的历史记录。

公共数据工具（无需身份验证）

• fetch_ohlcv ：获取历史 OHLCV（烛台）数据。
• fetch_funding_rate ：获取永续期货合约的资金利率。
• fetch_long_short_ratio ：获取多头/空头比率（需要交易所特定的params ）。
• fetch_option_contract_data ：获取期权合约的市场数据。
• fetch_market_ticker ：获取某个符号的最新价格行情数据。
• fetch_public_market_trades ：获取某个符号的近期公开交易。

由于使用了Annotated和pydantic.Field ，每个工具都具有通过 MCP 协议本身提供的详细参数描述。

使用说明

• 期货/期权：当使用与期货或期权相关的工具（例如， fetch_open_positions 、 create_futures_limit_order 、 fetch_funding_rate ）时，请确保通过params参数正确配置 CCXT 客户端，特别是如果交易所需要或不默认为所需的市场类型，则传递{'options': {'defaultType': 'future'}} （或'swap' 、 'option' ）。
• fetch_long_short_ratio ：这不是 CCXT 统一的标准方法。您必须在params参数中提供具体的交易所方法名称及其参数（例如，对于币安合约， params={'method_name': 'fapiPublicGetGlobalLongShortAccountRatio', 'method_params': {'symbol': 'BTCUSDT', 'period': '5m'}} ）。
• 错误处理：如果在 CCXT 调用期间出现问题，工具将返回带有"error"键的字典。