加密货币市场数据 MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过与主要交易所集成提供实时和历史加密货币市场数据。该服务器使 Claude 等大型语言模型能够获取当前价格、分析市场趋势和访问详细的交易信息。

特性

实时市场数据
- 当前加密货币价格
- 带有买卖价差的市场摘要
- 按交易量排列的前几名交易对
- 多交易所支持
历史分析
- OHLCV（K 线图）数据
- 价格变化统计
- 交易量历史追踪
- 可自定义的时间范围
交易所支持
- Binance
- Coinbase
- Kraken
- KuCoin
- HyperLiquid
- Huobi
- Bitfinex
- Bybit
- OKX
- MEXC

安装

通过 Smithery 安装

要通过 Smithery 自动安装用于 Claude Desktop 的加密货币市场数据服务器：

使用 npm 包管理器安装：

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

手动安装

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

# 使用 pip
pip install mcp ccxt

使用方法

运行服务器

python crypto_server.py

连接 Claude 桌面端

打开 Claude 桌面端配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
添加服务器配置：

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

重启 Claude 桌面端

可用工具

get-price
- 获取任何交易对的当前价格
- 例如：“币安上BTC/USDT的当前价格是多少？”
get-market-summary
- 获取详细的市场信息
- 例如：“给我显示ETH/USDT的市场概览”
get-top-volumes
- 按交易量列出主要的交易对
- 例如：“Kraken上交易量最大的5个交易对是什么？”
list-exchanges
- 显示所有支持的交易所
- 例如：“支持哪些交易所？”
get-historical-ohlcv
- 获取历史K线数据
- 例如：“显示过去7天BTC/USDT价格数据，以1小时为间隔”
get-price-change
- 计算不同时间段的价格变化
- 例如：“SOL/USDT的24小时价格变化是多少？”
get-volume-history
- 追踪一段时间内的交易量
- 例如：“显示过去一周ETH/USDT的交易量历史”

示例查询

连接服务器后，您可以向 Claude 提问以下示例问题：

Binance 上比特币的当前价格是多少？
显示 Coinbase 上交易量最大的 5 个交易对
ETH/USDT 在过去 24 小时内的表现如何？
给出 Kraken 上 SOL/USDT 的详细市场摘要
BNB/USDT 在过去一周的交易量历史是多少？

技术细节

依赖项

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

架构

服务器使用：

CCXT 的异步支持，以实现高效的交易所通信
MCP 的工具系统，用于 LLM 集成
标准化的数据格式，以确保输出一致性
连接池，以实现最佳性能

错误处理

服务器实现了强大的错误处理机制，用于处理：

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

开发

运行测试

# 待实现
pytest tests/

贡献

Fork 代码库
创建一个功能分支
进行更改
提交拉取请求

本地开发

# 克隆代码库
git clone [repository-url]
cd crypto-mcp-server

# 安装依赖项
pip install -e .

故障排除

常见问题

交易所连接错误
- 检查您的网络连接
- 验证交易所是否正常运行
- 确保所选交易所存在该交易对
速率限制
- 在请求之间实现延迟
- 对高频查询使用不同的交易所
- 检查特定交易所的速率限制
数据格式问题
- 验证交易对格式（例如，BTC/USDT，而不是BTCUSDT）
- 检查时间范围规范
- 确保数值参数在有效范围内

许可证

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

致谢

感谢 CCXT 提供交易所集成
感谢 Model Context Protocol 提供 MCP 规范
感谢各个加密货币交易所提供市场数据 API