Cryptocurrency Market Data MCP Server

加密货币市场数据 MCP 服务

一个模型上下文协议（MCP）服务，通过与主流交易所集成，提供实时和历史加密货币市场数据。此服务可让 Claude 等大模型获取当前价格、分析市场趋势并访问详细的交易信息。

功能

• 实时市场数据

  • 当前加密货币价格
  • 包含买卖价差的市场摘要
  • 按交易量排列的热门交易对
  • 支持多个交易所

• 历史分析

  • OHLCV（蜡烛图）数据
  • 价格变化统计
  • 交易量历史跟踪
  • 可自定义时间范围

• 支持的交易所

  • Binance
  • Coinbase
  • Kraken
  • KuCoin
  • HyperLiquid
  • Huobi
  • Bitfinex
  • Bybit
  • OKX
  • MEXC

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装加密货币市场数据服务：

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

手动安装

# Using uv (recommended)
uv pip install mcp ccxt

# Using pip
pip install mcp ccxt

使用

运行服务

python crypto_server.py

连接 Claude Desktop

1. 打开 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 添加服务配置：

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

3. 重启 Claude Desktop

可用工具

1. get-price

   • 获取任意交易对的当前价格
   • 示例：“Binance 上 BTC/USDT 的当前价格是多少？”

2. get-market-summary

   • 获取详细的市场信息
   • 示例：“显示 ETH/USDT 的市场摘要”

3. get-top-volumes

   • 按交易量列出热门交易对
   • 示例：“Kraken 上交易量排名前 5 的交易对有哪些？”

4. list-exchanges

   • 显示所有支持的交易所
   • 示例：“支持哪些交易所？”

5. get-historical-ohlcv

   • 获取历史蜡烛图数据
   • 示例：“显示 BTC/USDT 过去 7 天、间隔为 1 小时的价格数据”

6. get-price-change

   • 计算不同时间范围内的价格变化
   • 示例：“SOL/USDT 过去 24 小时的价格变化是多少？”

7. get-volume-history

   • 跟踪一段时间内的交易量
   • 示例：“显示 ETH/USDT 过去一周的交易量历史”

示例查询

连接服务后，你可以向 Claude 提出以下问题：

- What's the current Bitcoin price on Binance?
- Show me the top 5 trading pairs by volume on Coinbase
- How has ETH/USDT performed over the last 24 hours?
- Give me a detailed market summary for SOL/USDT on Kraken
- What's the trading volume history for BNB/USDT over the last week?

技术详情

依赖项

• mcp：模型上下文协议 SDK
• ccxt：加密货币交易所交易库
• Python 3.9 或更高版本

架构

该服务使用：

• CCXT 的异步支持，高效地与交易所通信
• MCP 的工具系统，集成大模型
• 标准化的数据格式，确保输出一致
• 连接池，优化性能

错误处理

该服务针对以下情况实现了可靠的错误处理：

• 无效的交易对
• 交易所连接问题
• 速率限制
• 格式错误的请求
• 网络超时

开发

运行测试

# To be implemented
pytest tests/

贡献

1. Fork 此代码库
2. 创建功能分支
3. 进行更改
4. 提交拉取请求

本地开发

# Clone the repository
git clone [repository-url]
cd crypto-mcp-server

# Install dependencies
uv pip install -e .

故障排除

常见问题

1. 交易所连接错误

   • 检查网络连接
   • 确认交易所运行正常
   • 确保所选交易所支持该交易对

2. 速率限制

   • 在请求之间添加延迟
   • 高频查询时使用不同的交易所
   • 查看交易所特定的速率限制

3. 数据格式问题

   • 确认交易对格式（例如，BTC/USDT，而不是 BTCUSDT）
   • 检查时间范围规格
   • 确保数值参数在有效范围内

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件

致谢

• CCXT，提供交易所集成
• Model Context Protocol，提供 MCP 规范
• 提供市场数据 API 的加密货币交易所