Crypto Market Data

加密货币市场数据 MCP 服务

一个只读的 Model Context Protocol 服务，可通过 CCXT 为任何 AI Agent（Claude、Cursor、Cline、Windsurf……）提供来自 100 多家交易所的实时加密货币市场数据。无需 API 密钥——所有数据均通过公共端点获取。

支持的交易所：bybit、binance、okx、hyperliquid、gate、kucoin（可在 SUPPORTED_EXCHANGES 中添加更多 CCXT ID）。

通过 MCPize 连接

无需本地安装，即可立即使用此 MCP 服务：

npx -y mcpize connect @eliasfire617/crypto-market-data --client claude

或连接至：https://mcpize.com/mcp/crypto-market-data

工具（13 个）

发现

工具	功能
list_exchanges	查看支持哪些交易所
get_capabilities	查看各交易所支持哪些数据的矩阵（不联网）
search_symbols	查找某个币种的准确符号格式

市场数据

工具	功能
get_price	最新价格 + 24 小时统计数据
get_order_book	最优买价/卖价
get_ohlcv	最近的 OHLCV 蜡烛图数据
get_recent_trades	最新公开交易记录

衍生品

工具	功能
get_funding_rate	当前永续合约资金费率
get_funding_rate_history	历史资金费率
compare_funding	多家交易所的资金费率 + 套利价差
get_open_interest	当前未平仓合约量
get_long_short_ratio	全局多空账户比率（Binance）
get_liquidations	最近的公开清算数据（支持有限）

compare_funding 是其独特之处：它通过一次并发调用，呈现资金费率套利机会（比较哪家交易所支付的费率最高或最低）。 比较前会将费率年化（apr_pct）——各交易所的资金费率结算频率不同（Hyperliquid 每小时结算一次，其他交易所每 8 小时结算一次），因此原始费率无法直接比较。

想要分析结果，而不仅是数据？ 配套服务 Crypto Derivatives Intelligence 基于这些数据，提供扣除费用后的资金费率套利机会（盈亏平衡天数、可执行深度）、未平仓合约量与价格背离、清算区间、仓位极端情况和市场状态分类——每项分析只需调用一次工具。

稳健性

专为生产环境打造，而非演示用途：

• 瞬时网络错误时进行指数退避重试（最多 3 次）。
• 单次请求和整体超时（10 秒 / 25 秒），避免交易所无响应导致调用停滞。
• 能力检查：不会调用交易所不支持的方法——会返回清晰的错误，并列出实际支持该方法的交易所（参见 get_capabilities）。
• 结构化错误（{"error": {type, message, retryable, supported_exchanges}}），而非崩溃——Agent 始终能收到可解析的响应。
• TTL 响应缓存（重复调用速度约快 660 倍；有助于缓解速率限制）。
• 对每项工具进行输入验证，并限制参数范围。
• 确保清理交易所连接；日志仅写入 stderr（适用于 stdio 传输）。

在本地运行

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# stdio transport (Claude Desktop, Cursor, Cline) — local, no auth:
python server.py

# OR streamable HTTP (hosted / remote) — API-key auth + rate limiting ON:
python server.py --http                 # binds :8000 (override with PORT=8799)

身份验证与计费（HTTP 模式）

托管的 HTTP 传输设有访问门槛，因此可以计费。本地 stdio 模式保持开放，供单用户开发使用。

• 客户端发送 Authorization: Bearer <api-key>。

• 每个密钥对应一个 client_id 和一个套餐；未知或缺失的密钥会返回 401。

• 套餐（auth.py → TIERS）用于设置每分钟速率限制和每月配额：

  套餐	每分钟请求数	月配额
  free	10	1,000
  pro	120	100,000
  ultra	600	2,000,000

• 超出限额时会返回清晰的 ToolError（Rate limit exceeded… / Monthly quota exceeded…），而不会崩溃。

配置密钥（任一来源均可；文件优先）：

# inline
export CRYPTO_MCP_API_KEYS="sk_live_abc:acme:pro,sk_live_xyz:jane:free"
# or a file (see api_keys.example.json)
export CRYPTO_MCP_API_KEYS_FILE=./api_keys.json

如果 HTTP 模式下未设置任何密钥，系统会生成一个临时的**演示密钥（tier=pro）**并打印到 stderr，供你立即测试。

通过网关（例如 MCPize）

如果你部署在一个已对订阅用户进行身份验证并且限流的平台之后，请设置 CRYPTO_MCP_DISABLE_AUTH=1。此时，服务会信任网关并跳过自身的身份验证和限流，避免重复身份验证和重复限流。仅当容器只能通过该网关访问时才这样做。

与 Claude Desktop 配合使用

将 claude_desktop_config.example.json 复制到你的 Claude Desktop 配置文件中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json， Windows 上为 %APPDATA%\Claude\claude_desktop_config.json），并相应调整路径。

交易对

• 现货：BTC/USDT
• 永续合约：BTC/USDT:USDT
• 常见简写会自动规范化：btc、BTCUSDT、BTC-USDT 均可使用（资金费率/OI 工具会转换为永续合约格式）。

---

路线图

• 在 SUPPORTED_EXCHANGES 中添加更多交易所。
• 对热门交易对进行更积极的缓存，以降低延迟。
• 提供可选的 WebSocket 实时订单簿/交易数据流。