使用说明
CoinGlass MCP服务器
MCP服务器 CoinGlass 加密货币衍生品分析。提供AI代理访问 80多个API终点 通过 22个统一工具.
特性
- 22个MCP工具 -80多个CoinGlass API端点的统一接口
- 计划感知门控 --基于订阅层的自动功能限制
- 响应缓存 --通过FastMCP中间件内置缓存（60s TTL）
- 重试逻辑 --临时故障自动重试（5xx，超时）
- 类型安全 --带有Literal类型操作的完整类型提示，以提高LLM的清晰度
- 异步优先 --基于httpx+FastMCP构建，实现高性能
快速开始
安装
pip install coinglass-mcp
或与 紫外线:
uv pip install coinglass-mcp
配置
export COINGLASS_API_KEY="your-api-key"
export COINGLASS_PLAN="standard" # hobbyist | startup | standard | professional | enterprise
获取API密钥： coinglas.com/pricing
跑
coinglass-mcp
Claude桌面集成
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"coinglass": {
"command": "coinglass-mcp",
"env": {
"COINGLASS_API_KEY": "your-api-key",
"COINGLASS_PLAN": "standard"
}
}
}
}
可用工具
| 类别 | 工具 | 描述 |
|---|---|---|
| 市场 | coinglass_market_info |
支持的硬币、货币对、交易所 |
coinglass_market_data |
实时市场总结 | |
coinglass_price_history |
OHLC价格蜡烛 | |
| 开放兴趣 | coinglass_oi_history |
OI OHLC（配对/聚合/稳定币/硬币保证金） |
coinglass_oi_distribution |
OI按交易所细分 | |
| 资金 | coinglass_funding_history |
资金利率OHLC |
coinglass_funding_current |
当前利率、累计利率、套利利率 | |
| 长/短 | coinglass_long_short |
全球比率、顶级客户、顶级头寸 |
| 清算 | coinglass_liq_history |
OHLC清算历史 |
coinglass_liq_orders |
实时清算流⚡ | |
coinglass_liq_heatmap |
清算热图🔥 | |
| 订单簿 | coinglass_ob_history |
买卖深度历史 |
coinglass_ob_large_orders |
鲸鱼墙检测 | |
| 鲸 | coinglass_whale_positions |
超液态鲸鱼的位置⚡ |
coinglass_whale_index |
鲸鱼活动指数 | |
| 取者 | coinglass_taker |
接受者买入/卖出量和比率 |
| 斑点 | coinglass_spot |
现货市场数据和价格 |
| 选项 | coinglass_options |
最大疼痛、OI、交易量（BTC/ETH） |
| 链上 | coinglass_onchain |
外汇余额、流量、转账 |
| 交易所交易基金 | coinglass_etf |
比特币/以太坊ETF流量 |
coinglass_grayscale |
灰度持股和溢价 | |
| 指标 | coinglass_indicators |
RSI、恐惧与贪婪、彩虹、Pi循环等。 |
| 元 | coinglass_search |
按关键字查找工具 |
coinglass_config |
查看交换、间隔、功能 |
⚡ 需要启动+计划|🔥 需要专业+计划
平面图特征
| 特色 | 业余爱好者 | 初创企业 | 标准 | 专业 |
|---|---|---|---|---|
| 基本间隔（h4、h8、d1） | ✅ | ✅ | ✅ | ✅ |
| 延长间隔（m1-h1） | ❌ | ✅ | ✅ | ✅ |
| 鲸鱼警报和位置 | ❌ | ✅ | ✅ | ✅ |
| 清算订单流 | ❌ | ❌ | ✅ | ✅ |
| 清算热图 | ❌ | ❌ | ❌ | ✅ |
使用示例
市场概述
# Get all coins summary
coinglass_market_data(action="coins_summary")
# Get BTC metrics only
coinglass_market_data(action="coins_summary", symbol="BTC")
未平仓合约分析
# BTC OI across all exchanges
coinglass_oi_history(action="aggregated", symbol="BTC")
# OI distribution by exchange
coinglass_oi_distribution(action="by_exchange", symbol="BTC")
融资利率套利
# Current funding rates
coinglass_funding_current(action="rates")
# Find arbitrage opportunities
coinglass_funding_current(action="arbitrage")
鲸鱼追踪
# Recent whale alerts (Hyperliquid)
coinglass_whale_positions(action="alerts")
# Large BTC positions
coinglass_whale_positions(action="positions", symbol="BTC")
市场情绪
# Fear & Greed Index
coinglass_indicators(action="fear_greed")
# Bitcoin Rainbow Chart
coinglass_indicators(action="rainbow")
工具发现
# Search for liquidation-related tools
coinglass_search(query="liquidation")
# Check available features for your plan
coinglass_config(action="plan_features")
建筑
coinglass-mcp/
├── src/coinglass_mcp/
│ ├── server.py # FastMCP server + 22 tools
│ ├── client.py # HTTP client with retry logic
│ └── config.py # Plan tiers, intervals, features
├── tests/
│ ├── test_client.py
│ └── test_tools.py
└── pyproject.toml
设计原则：
- 3文件架构 --针对AI代理理解进行了优化
- 域外观图案 --22工具→ 80+ 端点
- 文字类型的操作 --帮助LLM选择正确的操作
- 寿命模式 --共享httpx。AsyncClient提高效率
发展
设置
git clone https://github.com/forgequant/coinglass-mcp.git
cd coinglass-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
测试
pytest -v
======================== 45 passed in 0.69s ========================
在本地运行
export COINGLASS_API_KEY="your-key"
python -m coinglass_mcp.server
FastMCP云部署
入口点： coinglass_mcp.server:mcp
环境变量：
COINGLASS_API_KEY-您的CoinGlass API密钥COINGLASS_PLAN--订阅层（默认值：standard)
api参考
完整的CoinGlass API文档： open-api.coinglass.com
许可证
麻省理工学院
