CCXT MCP 服务器

Version MCP Standard smithery badge

使用 MCP（模型上下文协议）和 CCXT 实现高性能的加密货币交易所集成。

功能

🚀 交易所支持：连接 20 多个加密货币交易所
🔃 市场类型：支持现货、期货、互换市场等
🔧 代理配置：提供通过代理访问交易所的选项
📊 快速可靠：优化的缓存和速率限制
🌐 MCP 标准：通过 MCP 兼容 Claude 和 GPT 等大型语言模型

CCXT MCP 服务器集成架构

CCXT MCP 服务器通过模型上下文协议将语言模型连接到加密货币交易所。它作为一个桥梁，允许大型语言模型通过统一的 API 访问实时市场数据并在多个交易所执行交易操作。

架构包括：

发送请求的大型语言模型客户端（Claude 和其他兼容 MCP 的模型）
标准化通信的模型上下文协议（MCP）
处理请求并管理交易所交互的 CCXT MCP 服务器
提供统一访问交易所 API 的 CCXT 库
连接到多个加密货币交易所

CCXT MCP 服务器代码架构

为了更好地维护和扩展，服务器分为三个主要模块：

交易所：管理交易所实例、凭证和符号验证
工具：提供缓存、速率限制和日志功能
工具：实现 MCP 工具和资源以进行交易所交互

快速开始

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 mcp-server-ccxt：

npx -y @smithery/cli install @doggybee/mcp-server-ccxt --client claude

NPM 包（推荐）

你可以从 npm 安装 CCXT MCP 服务器：

# 全局安装
npm install -g @mcpfun/mcp-server-ccxt

# 启动服务器
mcp-server-ccxt

或者直接运行：

npx @mcpfun/mcp-server-ccxt

手动安装

你也可以克隆并构建仓库：

# 克隆仓库
git clone https://github.com/doggybee/mcp-server-ccxt.git
cd mcp-server-ccxt

# 安装依赖
npm install

# 构建服务器
npm run build

# 启动服务器
npm start

配置

创建环境文件
```
cp .env.example .env
```

编辑 .env 文件以添加你的交易所 API 密钥

# 默认交易所（可选）
DEFAULT_EXCHANGE=binance

# 默认市场类型（可选）
DEFAULT_MARKET_TYPE=spot 

# API 凭证（可选）
BINANCE_API_KEY=your_api_key
BINANCE_SECRET=your_api_secret
# 对于需要密码的交易所（例如 KuCoin）
KUCOIN_API_KEY=your_kucoin_api_key
KUCOIN_SECRET=your_kucoin_secret
KUCOIN_PASSPHRASE=your_kucoin_passphrase

# 代理配置（可选）
USE_PROXY=false
PROXY_URL=http://username:password@your-proxy-server:port
# 旧格式（仍支持，但建议使用上述集成 URL 格式）
# PROXY_USERNAME=
# PROXY_PASSWORD=

使用

注意：如果遇到 MCP 通信问题，请参阅故障排除指南以获取解决方案。

运行服务器

启动服务器：

# 如果通过 npm 全局安装
mcp-server-ccxt

# 如果手动安装
npm start

与 Claude for Desktop 一起使用

将服务器添加到你的 claude_desktop_config.json 中：

如果通过 npm 全局安装：

{
  "mcpServers": {
    "ccxt": {
      "command": "mcp-server-ccxt"
    }
  }
}

如果手动安装：

{
  "mcpServers": {
    "ccxt": {
      "command": "node",
      "args": [
        "/path/to/mcp-server-ccxt/build/index.js"
      ]
    }
  }
}

重启 Claude for Desktop

作为模块在其他项目中使用

你也可以在你的 Node.js 项目中将此包作为模块使用：

// 导入 CCXT MCP 服务器
import '@mcpfun/mcp-server-ccxt';

// 服务器在导入时自动启动
// 你可以通过环境变量进行配置

示例查询

以下是一些你可以与 MCP 服务器一起使用的示例查询：

"Binance 上比特币的当前价格是多少？"
"显示 Coinbase 上 ETH/USDT 的订单簿"
"获取 Binance 上 BTC/USDT 过去 24 根蜡烛的 1 小时 OHLCV 数据"
"比较不同交易所上 SOL/USDT 的价格"
"我在 Binance 上的当前余额是多少？"（需要 API 密钥）
"在 Kraken 上以市价买入 0.1 ETH"（需要 API 密钥）

可用工具

公共 API 工具

list-exchanges：列出所有可用的加密货币交易所
get-ticker：获取交易对的当前行情信息
batch-get-tickers：一次性获取多个交易对的行情信息
get-orderbook / get-order-book：获取交易对的市场订单簿
get-ohlcv：获取交易对的 OHLCV 蜡烛图数据
get-trades：获取交易对的最近交易记录
get-markets：获取交易所的所有可用市场
get-exchange-info：获取交易所信息和状态
get-leverage-tiers：获取期货杠杆层级
get-funding-rates：获取当前资金费率
get-positions：获取未平仓头寸信息
get-open-orders：获取所有未平仓订单
get-order-history：获取订单历史

私有 API 工具（需要 API 密钥）

account-balance：从加密货币交易所获取你的账户余额
place-market-order：在交易所上下市价单
place-limit-order：在交易所上下限价单
cancel-order：取消现有订单
cancel-all-orders：取消所有未平仓订单
set-leverage：设置期货杠杆
set-margin-mode：设置期货保证金模式
place-futures-market-order：下期货市价单
place-futures-limit-order：下期货限价单
transfer-funds：在账户之间转移资金（例如，现货到期货）

配置和实用工具

cache-stats：获取 CCXT 缓存统计信息
clear-cache：清除 CCXT 缓存
set-log-level：设置日志级别
get-proxy-config：获取代理设置
set-proxy-config：配置代理设置
set-market-type：设置默认市场类型
set-default-exchange：更改默认交易所
system-info：获取系统和环境信息

性能优化

MCP-CCXT 包含多项优化以确保高性能：

LRU 缓存系统：
- 不同类型数据的不同 TTL
- 行情数据：10 秒
- 订单簿数据：5 秒
- 市场数据：1 小时
自适应速率限制：
- 根据交易所响应自动调整请求速率
- 对错误实施指数退避
- 管理每个交易所的并发请求
交易所连接管理：
- 高效初始化交易所实例
- 正确的错误处理和重试

安全最佳实践

API 密钥安全

创建专用 API 密钥：
- 为不同的应用/用途创建单独的 API 密钥
- 切勿在不同服务或应用之间重复使用 API 密钥
限制 API 密钥权限：
- 仅启用你需要的权限（例如，市场数据的只读权限）
- 如果仅需要交易功能，则禁用提款权限
- 在可用时使用 IP 白名单以限制对已知 IP 的访问
安全存储：
- 切勿将 API 密钥提交到版本控制系统
- 将 API 密钥存储在环境变量或安全保险库中
- 使用 .env 文件并通过 .gitignore 排除在 git 之外

风险免责声明

本软件仅供信息目的使用。使用本软件与加密货币交易所交互涉及重大风险：

财务风险：加密货币交易涉及亏损风险
API 安全性：确保你的 API 密钥具有适当的权限限制
无投资建议：本工具不提供投资建议
无担保：本软件“按原样”提供，不提供任何形式的担保

许可证

本项目根据 MIT 许可证授权 - 详见 LICENSE.txt 文件。

版权和归属

本项目使用 CCXT 库 (https://github.com/ccxt/ccxt)，其版权如下：

Copyright (c) 2016-2024 CCXT 开发者

CCXT 根据 MIT 许可证发布，许可证内容如下：

特此免费授予任何获得本软件副本及相关文档文件（“软件”）的人，不受限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许获得本软件的人在被提供本软件的情况下这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

本软件“按原样”提供，不提供任何形式的担保，无论是明示或暗示的，包括但不限于适销性、特定用途适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任负责，无论是在合同、侵权或其他行为中，由本软件或本软件的使用或其他处理引起的或与之相关的。

如有问题、功能请求或贡献，请访问 GitHub 仓库。