项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 提供实时的加密货币市场数据。通过与主流加密货币交易所集成，该服务器允许LLM获取当前价格、分析市场趋势以及访问详细的交易信息，从而增强LLM在金融分析和相关应用中的能力。

主要功能点

• 实时市场数据: 提供多种加密货币的实时价格、市场概况（买卖价差）和交易量信息。
• 历史数据分析: 支持获取历史OHLCV（开盘价、最高价、最低价、收盘价、交易量）数据，用于趋势分析和回溯测试。
• 多交易所支持: 已集成包括币安 (Binance)、Coinbase、 Kraken、 KuCoin 等在内的多家主流加密货币交易所。
• 工具化访问: 通过预定义的工具 (Tools)，LLM 可以方便地调用服务器功能，例如查询价格、获取市场总结、列出交易对、查询历史数据等。

安装步骤

1. 安装依赖: 确保你的系统已安装 Python 3.9 或更高版本。推荐使用 'uv' 或 'pip' 包管理器安装项目依赖。

   # 使用 uv (推荐)
   uv pip install mcp ccxt
   
   # 使用 pip
   pip install mcp ccxt
   

服务器配置

要将此 MCP 服务器连接到 MCP 客户端（例如 Claude Desktop），你需要在客户端中配置服务器的启动命令。以下是 Claude Desktop 的配置示例 (JSON 格式)：

{
    "mcpServers": {
        "crypto": {
            "command": "python",
            "args": ["/path/to/crypto_server.py"]
        }
    }
}

配置信息说明:

• 'server name': 'crypto' (服务器名称，可以自定义，用于在客户端配置中标识该服务器)
• 'command': 'python' (启动服务器的命令，确保你的 Python 环境配置正确)
• 'args': '["/path/to/crypto_server.py"]' (命令参数，指向 'crypto_server.py' 脚本的路径。请将 '/path/to/crypto_server.py' 替换为实际的文件路径)

基本使用方法

1. 启动服务器: 在安装依赖后，通过以下命令启动 MCP 服务器：

   python crypto_server.py
   

2. 配置 MCP 客户端: 根据你的 MCP 客户端（如 Claude Desktop）的配置方法，填入上述服务器配置信息。确保客户端能够连接到正在运行的 MCP 服务器。

3. 通过 LLM 提问: 连接成功后，你可以向 LLM 提出关于加密货币市场数据的问题。LLM 将调用服务器提供的工具来获取数据并生成答案。例如，你可以提问：

   • "Binance 上比特币现在的价格是多少？"
   • "展示 Coinbase 上交易量前 5 的交易对"
   • "过去 24 小时 ETH/USDT 的表现如何？"
   • "给我 Kraken 上 SOL/USDT 的详细市场总结"
   • "BNB/USDT 过去一周的交易量历史是多少？"

更多可用的工具和示例查询，请参考仓库的 README 文档。