CCXT MCP 服务器

한국어 버전(韩语版本)

CCXT MCP 服务器是一个允许 AI 模型通过 模型上下文协议 (MCP) 与加密货币交易所 API 交互的服务器。此服务器使用 CCXT 库 提供对 100 多个加密货币交易所及其交易功能的访问。

🚀 快速开始

# 全局安装包
npm install -g @lazydino/ccxt-mcp

# 使用默认设置运行
ccxt-mcp

# 或者无需安装即可运行
npx @lazydino/ccxt-mcp

安装和使用

全局安装

# 全局安装包
npm install -g @lazydino/ccxt-mcp

使用 npx 运行

您可以直接运行它，无需安装：

# 使用默认设置
npx @lazydino/ccxt-mcp

# 使用自定义配置文件
npx @lazydino/ccxt-mcp --config /path/to/config.json

查看帮助：

npx @lazydino/ccxt-mcp --help

配置

在 Claude Desktop 中注册 MCP 服务器

1. 打开 Claude Desktop 设置：

   • 转到 Claude Desktop 应用程序中的“设置”菜单
   • 找到“MCP 服务器”部分

2. 添加新的 MCP 服务器：

   • 单击“添加服务器”按钮
   • 服务器名称：ccxt-mcp
   • 命令：npx @lazydino/ccxt-mcp
   • 附加参数（可选）：--config /path/to/config.json

3. 保存并测试服务器：

   • 保存设置
   • 使用“测试连接”按钮测试连接

配置方法 - 两种选择

选项 1：直接在 Claude Desktop 设置中包含帐户信息（基本方法）

此方法将 CCXT 帐户信息直接包含在 Claude Desktop 设置文件 (claude_desktop_config.json) 中：

{
  "mcpServers": {
    "ccxt-mcp": {
      "command": "npx",
      "args": ["-y", "@lazydino/ccxt-mcp"],
      "accounts": [
        {
          "name": "bybit_main",
          "exchangeId": "bybit",
          "apiKey": "YOUR_API_KEY",
          "secret": "YOUR_SECRET_KEY",
          "defaultType": "spot"
        },
        {
          "name": "bybit_futures",
          "exchangeId": "bybit",
          "apiKey": "YOUR_API_KEY",
          "secret": "YOUR_SECRET_KEY",
          "defaultType": "swap"
        }
      ]
    }
  }
}

使用此方法，您不需要单独的配置文件。所有设置都集成到 Claude Desktop 配置文件中。

选项 2：使用单独的配置文件（高级方法）

要将帐户信息分离到单独的配置文件中，请按如下方式设置：

1. 创建单独的配置文件（例如，ccxt-accounts.json）：

{
  "accounts": [
    {
      "name": "bybit_main",
      "exchangeId": "bybit",
      "apiKey": "YOUR_API_KEY",
      "secret": "YOUR_SECRET_KEY",
      "defaultType": "spot"
    },
    {
      "name": "bybit_futures",
      "exchangeId": "bybit",
      "apiKey": "YOUR_API_KEY",
      "secret": "YOUR_SECRET_KEY",
      "defaultType": "swap"
    }
  ]
}

重要提示：配置文件必须在根级别包含一个 accounts 数组，如上所示。

2. 在 Claude Desktop 设置中指定配置文件路径：

{
  "mcpServers": {
    "ccxt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@lazydino/ccxt-mcp",
        "--config",
        "/path/to/ccxt-accounts.json"
      ]
    }
  }
}

注意：当使用带有 --config 选项的单独配置文件时，服务器将直接在 JSON 文件的根目录中查找 accounts 数组，而不是在 mcpServers.ccxt-mcp.accounts 路径中查找。

3. 从命令行使用外部配置文件运行：

# 使用自定义配置文件
npx @lazydino/ccxt-mcp --config /path/to/ccxt-accounts.json

您可以在存储库的 examples/config-example.json 中找到示例配置文件。

使用单独配置文件的原因：

• 防止递归引用问题
• 分离敏感信息，如 API 密钥
• 更容易进行多环境配置（开发、测试、生产）
• 改进配置文件版本控制

主要功能

• 市场信息检索：

  • 列出交易所
  • 按交易所查看市场信息
  • 获取特定交易对的价格信息
  • 查看特定交易对的订单簿信息
  • 搜索历史 OHLCV 数据

• 交易功能：

  • 创建市价/限价订单
  • 取消订单并检查状态
  • 查看帐户余额
  • 检查交易历史

• 交易分析：

  • 每日/每周/每月表现分析
  • 胜率计算（过去 7 天、30 天、所有时间）
  • 平均盈亏比（R 倍数）
  • 最大连续亏损/盈利系列分析
  • 资产变动跟踪
  • 综合绩效指标
  • 交易模式识别
  • 基于周期的回报计算

• 仓位管理：

  • 资本比率交易（例如，以帐户资本的 5% 进入）
  • 期货市场杠杆设置（1-100 倍）
  • 动态仓位大小调整（基于波动率）
  • 分割买入/卖出策略实施

• 风险管理：

  • 基于技术指标的止损设置（例如，5 分钟图上 10 根蜡烛中的最低点）
  • 基于波动率的止损/止盈（ATR 倍数）
  • 最大允许损失限额（每日/每周）
  • 动态止盈设置（追踪利润）

工作原理

用户 <--> AI 模型(Claude/GPT) <--> MCP 协议 <--> CCXT MCP 服务器 <--> 加密货币交易所 API

1. 用户：请求，例如“告诉我比特币的价格”或“在我的 Binance 帐户上购买以太坊”
2. AI 模型：理解用户请求并确定要使用哪些 MCP 工具/资源
3. MCP 协议：AI 和 CCXT MCP 服务器之间的标准化通信
4. CCXT MCP 服务器：使用 CCXT 库与加密货币交易所 API 通信
5. 交易所 API：提供实际数据并执行交易订单

与 AI 模型一起使用

在 Claude Desktop 中注册后，您可以向 AI 模型发出以下类型的请求：

注意事项和推荐提示

使用 AI 模型时，请考虑以下注意事项并使用以下提示以进行有效交易：

你的目标是尽可能使用 ccxt 工具执行交易
注意事项：
- 在进行交易之前，准确识别是期货市场还是现货市场
- 如果没有关于资本百分比或使用金额的说明，始终计算并使用所有可用资本执行交易

注意：

• AI 模型有时会将期货交易与现货交易混淆。
• 如果没有关于交易资本规模的明确指导，AI 可能会感到困惑。
• 使用上述提示有助于清楚地传达您的交易意图。

基本查询示例

检查并比较 binance 和 coinbase 上的当前比特币价格。

高级交易查询示例

仓位管理

在我的 Bybit 帐户 (bybit_futures) 中以 10 倍杠杆使用 5% 的资本开设 BTC/USDT 期货市场的多头头寸。
根据移动平均线交叉策略进入，并将止损设置在最近 12 根 5 分钟蜡烛中的最低点。

绩效分析

分析我过去 7 天的 Binance 帐户 (bybit_main) 交易记录，并向我展示胜率、平均利润和最大连续亏损。

详细交易分析

分析我过去 30 天在 bybit_futures 帐户上 BTC/USDT 的交易表现。计算胜率、利润因子，并识别我盈利交易中的任何模式。

向我展示过去 90 天我的 bybit_main 帐户的每月回报，并确定我最佳和最差的交易月份。

分析我在 bybit_futures 帐户上的连续盈利和亏损，并告诉我我是否在亏损后有任何影响我交易的心理模式。

开发

从源代码构建

# 克隆存储库
git clone https://github.com/lazy-dinosaur/ccxt-mcp.git

# 导航到项目目录
cd ccxt-mcp

# 安装依赖项
npm install

# 构建
npm run build

🤝 贡献

欢迎贡献！请随时提交拉取请求。

📄 许可证

根据 MIT 许可证分发。有关更多信息，请参见 LICENSE 文件。

❤️ 支持

如果您觉得这个项目有用，请考虑在 GitHub 上给它一个 ⭐️！