项目简介

CCXT MCP Server 是一个 MCP (Model Context Protocol) 服务器实现，它利用强大的 CCXT (CryptoCurrency eXchange Trading Library) 库，为 AI 模型（如 Claude）提供访问全球 100 多个加密货币交易所的接口。通过此服务器，AI 模型可以查询市场数据、执行交易、管理账户，以及进行交易分析和风险控制。

主要功能点

市场数据访问: 获取实时和历史市场信息，包括交易对、价格、订单簿、交易历史等。
交易功能: 支持在交易所进行现货和期货交易，包括创建、取消、查询订单等。
账户管理: 查看账户余额、交易记录、充提币历史等。
交易分析: 提供基础的交易绩效分析功能。
风险管理: 支持设置止损、止盈等风险控制策略。

核心特点:

MCP 标准协议: 遵循 Model Context Protocol，易于与支持 MCP 的 AI 客户端集成。
CCXT 库集成: 支持广泛的加密货币交易所，功能丰富且稳定。
灵活配置: 支持多种配置方式，方便用户管理交易所账户信息。

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm (Node 包管理器)。

全局安装 CCXT MCP Server: 打开终端，运行以下命令进行全局安装：

npm install -g @lazydino/ccxt-mcp

服务器配置

CCXT MCP Server 需要在 MCP 客户端（例如 Claude Desktop）中进行配置才能连接使用。配置的关键是提供服务器的启动命令和参数。

在 Claude Desktop 的 MCP Servers 设置中，添加新的 MCP Server，并填写以下信息：

Server name: 'ccxt-mcp' (可以自定义名称)
Command: 'npx'
Arguments: '@lazydino/ccxt-mcp'

参数说明:

'npx': Node.js 的包执行器，用于运行未全局安装的 npm 包或全局安装包的可执行文件。
'@lazydino/ccxt-mcp': 要执行的 npm 包名称，即 CCXT MCP Server。

高级配置 (可选):

如果您需要使用单独的配置文件来管理账户信息，可以使用 '--config' 参数指定配置文件路径。例如，如果您的配置文件路径为 '/path/to/ccxt-accounts.json'，则 Arguments 应配置为：

Arguments: '@lazydino/ccxt-mcp --config /path/to/ccxt-accounts.json'

Claude Desktop MCP Server 配置 JSON 示例 (claude_desktop_config.json):

以下是在 'claude_desktop_config.json' 文件中配置 CCXT MCP Server 的示例。请注意，您通常不需要直接编辑此文件，而是在 Claude Desktop 应用的设置界面中进行配置。

基础配置 (账户信息直接在 Claude Desktop 配置中)：

{
  "mcpServers": {
    "ccxt-mcp": {  // Server name，与您在 Claude Desktop 设置中填写的名称一致
      "command": "npx",
      "args": ["-y", "@lazydino/ccxt-mcp"],
      "accounts": [  // 交易所账户信息
        {
          "name": "bybit_main",  // 账户名称，自定义，用于在工具调用中指定账户
          "exchangeId": "bybit",  // 交易所 ID，例如 "binance", "coinbase", "bybit" 等，参考 CCXT 库支持的交易所列表
          "apiKey": "YOUR_API_KEY",  // 您的交易所 API Key
          "secret": "YOUR_SECRET_KEY", // 您的交易所 Secret Key
          "defaultType": "spot" // 默认交易类型，例如 "spot" (现货), "swap" (永续合约) 等，根据您的账户类型设置
        },
        {
          "name": "binance_futures",
          "exchangeId": "binance",
          "apiKey": "YOUR_BINANCE_FUTURES_API_KEY",
          "secret": "YOUR_BINANCE_FUTURES_SECRET_KEY",
          "defaultType": "future"
        }
      ]
    }
  }
}

使用单独配置文件的高级配置 (ccxt-accounts.json)：

创建配置文件 'ccxt-accounts.json':

{
  "accounts": [
    {
      "name": "bybit_main",
      "exchangeId": "bybit",
      "apiKey": "YOUR_API_KEY",
      "secret": "YOUR_SECRET_KEY",
      "defaultType": "spot"
    },
    {
      "name": "binance_futures",
      "exchangeId": "binance",
      "apiKey": "YOUR_BINANCE_FUTURES_API_KEY",
      "secret": "YOUR_BINANCE_FUTURES_SECRET_KEY",
      "defaultType": "future"
    }
  ]
}

配置 Claude Desktop: 在 MCP Server 的 Arguments 中指定配置文件路径：
- Arguments: '@lazydino/ccxt-mcp --config /path/to/ccxt-accounts.json'

基本使用方法

启动 CCXT MCP Server: 在完成安装和配置后，当您在 Claude Desktop 中测试连接或使用相关功能时，CCXT MCP Server 会自动启动。
在 AI 模型中使用: 您可以使用自然语言指令指示 AI 模型使用 CCXT MCP Server 提供的工具和资源。例如，您可以询问：
- "Check and compare the current Bitcoin price on Binance and Coinbase." (检查币安和Coinbase的比特币当前价格)
- "What is the order book for ETH/USDT on Bybit?" (Bybit 交易所 ETH/USDT 的订单簿是什么？)
- "Buy 0.1 BTC on Binance using my binance_main account." (使用我的 binance_main 账户在币安购买 0.1 BTC)
- "Analyze my Bybit account (bybit_main) trading records for the last 7 days and show me the win rate." (分析我 Bybit (bybit_main) 账户过去 7 天的交易记录，并告诉我胜率。)

请参考仓库 README.md 中 "Using with AI Models" 部分的示例和提示，以获得更详细的使用指导。

注意: 使用交易功能时，请务必谨慎操作，并仔细检查 AI 模型的指令，以避免不必要的交易风险。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息