关键词

加密货币交易交易所APICCXT金融数据LLM工具

项目简介

CCXT MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当语言模型 (LLM) 和加密货币交易所之间的桥梁。该服务器利用强大的 CCXT 库，统一了多个交易所的 API 接口，使得 LLM 应用可以通过标准化的 MCP 协议轻松访问和操作加密货币市场数据，甚至进行交易。

主要功能点

  • 统一交易所接口: 支持 Binance, Coinbase, Kraken, KuCoin 等 9 个主流加密货币交易所，通过统一的 API 访问不同交易所的数据。
  • 全面的 API 功能: 提供市场数据查询（如行情、订单簿、K线数据、近期交易），以及账户信息和交易功能（需配置 API 密钥）。
  • 高性能设计: 内置缓存系统和自适应限速机制，优化数据访问速度和稳定性。
  • 专为 LLM 应用设计: 完全兼容 MCP 协议，方便 LLM 应用集成和调用。
  • 资源 (Resources): 提供交易所列表、市场信息、行情数据和订单簿等资源，方便 LLM 获取实时市场信息。
  • 工具 (Tools): 提供丰富的工具，包括：
    • 公共 API 工具: 查询交易所列表、获取行情、订单簿、K线数据、近期交易、市场信息、交易所信息等。
    • 私有 API 工具: 查询账户余额、下单交易等（需要配置交易所 API 密钥）。
    • 实用工具: 缓存管理、日志级别设置等。

安装步骤

推荐使用 NPM 包安装 (全局安装):

  1. 确保已安装 Node.js 和 npm。
  2. 打开终端，运行以下命令全局安装 CCXT MCP Server： 
    npm install -g @mcpfun/mcp-server-ccxt

手动安装步骤:

  1. 确保已安装 Node.js 和 npm。
  2. 克隆 GitHub 仓库到本地： 
    git clone https://github.com/doggybee/mcp-server-ccxt.git
cd mcp-server-ccxt
  3. 安装项目依赖： 
    npm install
  4. 构建服务器： 
    npm run build

服务器配置

  1. 创建 .env 配置文件: 复制 '.env.example' 文件并重命名为 '.env'：

    cp .env.example .env

  2. 编辑 .env 文件，配置交易所 API 密钥: 根据需要配置交易所的 API 密钥和 Secret。例如，配置 Binance 和 Coinbase 的 API 密钥：

    BINANCE_API_KEY=your_binance_api_key
BINANCE_SECRET=your_binance_secret

COINBASE_API_KEY=your_coinbase_api_key
COINBASE_SECRET=your_coinbase_secret

# ... 可以添加更多交易所的 API 密钥

    注意: 如果不需要使用私有 API 工具（如账户余额查询、交易），则无需配置 API 密钥。

  3. 设置默认交易所 (可选): 在 '.env' 文件中可以设置 'DEFAULT_EXCHANGE' 变量来指定默认交易所，例如设置为 'binance'：

    DEFAULT_EXCHANGE=binance

    如果未设置，默认使用 Binance。

MCP 客户端配置 (以 Claude for Desktop 为例):

MCP 客户端需要配置 MCP 服务器的启动命令才能连接。以下是 'claude_desktop_config.json' 的配置示例，无需修改代码，只需复制以下 JSON 配置到你的 MCP 客户端配置文件中：

如果使用 NPM 全局安装:

{
  "mcpServers": {
    "ccxt": {  // 服务器名称，可以自定义
      "command": "mcp-server-ccxt" // 启动服务器的命令
    }
  }
}

如果使用手动安装:

{
  "mcpServers": {
    "ccxt": {  // 服务器名称，可以自定义
      "command": "node", // 启动命令，使用 node 运行 JavaScript 文件
      "args": [  // 启动参数
        "/path/to/mcp-server-ccxt/build/index.js" //  指向手动安装目录下的 build/index.js 文件 (请替换为你的实际路径)
      ]
    }
  }
}

注意: 请将 '/path/to/mcp-server-ccxt' 替换为你手动安装 CCXT MCP Server 的实际路径。

基本使用方法

  1. 启动服务器:

    • NPM 全局安装: 在终端中运行命令 'mcp-server-ccxt' 即可启动服务器。
    • 手动安装: 在项目根目录下运行命令 'npm start' 启动服务器。

  2. 在 MCP 客户端中使用: 配置好 MCP 客户端后，客户端会自动连接到 CCXT MCP Server。你可以通过 MCP 客户端向服务器发送请求，例如：

    • 查询币安上比特币的当前价格: 'ccxt://binance/ticker/BTC/USDT'
    • 查询 Coinbase 上 ETH/USDT 的订单簿: 'ccxt://coinbase/orderbook/ETH/USDT'
    • 使用工具查询币安账户余额 (需要配置 API 密钥): 'tool_code:account-balance?exchange=binance&apiKey=YOUR_API_KEY&secret=YOUR_SECRET' (实际使用时请替换 'YOUR_API_KEY' 和 'YOUR_SECRET' 为你的 Binance API 密钥和 Secret)

    更多工具和资源的使用方法请参考仓库 'README.md' 文件中的 "Available Tools" 和 "Available Resources" 部分。

注意: 请仔细阅读 'README.md' 文件，了解更多高级用法、安全最佳实践和风险提示。

信息

分类

商业系统

访问项目