内容
# CoinGlass MCP 服务器
CoinGlass MCP 服务器连接 **Claude AI** 与 **CoinGlass API**，用于实时加密货币衍生品分析 — 针对 **Ricoz 剥头皮交易框架** 进行优化。
## 架构
```
Claude AI (claude.ai) ←── 流式 HTTP ──→ CoinGlass MCP 服务器 (VPS)
│
↓
CoinGlass API V4
```
## 18 种工具
### 关键工具（Ricoz 剥头皮交易核心）
| 工具 | 端点 | 功能 |
|------|----------|--------|
| `coinglass_spot_cvd` | 现货聚合 CVD | **否决信号** — 现货 CVD 为负 = 不要做多 |
| `coinglass_futures_cvd` | 期货聚合 CVD | 入场过滤器 — 确认方向 |
| `coinglass_funding_rate` | 所有交易所的资金费率 | 情绪 — 极端 = 反向 |
| `coinglass_open_interest` | 聚合历史持仓量 | 持仓 — 持仓量 + 价格方向 |
| `coinglass_liquidation_map` | 强制平仓集群 | 目标 — 磁性区域 |
| `coinglass_orderbook` | 订单簿增量历史 | 压力 — 买/卖不平衡 |
### 重要工具（支持分析）
| 工具 | 功能 |
|------|--------|
| `coinglass_price_ohlc` | 价格 OHLC 历史 |
| `coinglass_liquidation_history` | 强制平仓量随时间变化 |
| `coinglass_long_short_ratio` | 多/空比率（反向指标） |
| `coinglass_taker_buysell` | 做市商攻击方 |
| `coinglass_fr_arbitrage` | 所有币种的极端资金费率 |
| `coinglass_coins_markets` | 所有币种的市场概览 |
### 锦上添花工具
| 工具 | 功能 |
|------|--------|
| `coinglass_whale_alert` | 超大型鲸鱼仓位 |
| `coinglass_fear_greed` | 恐惧与贪婪指数 |
| `coinglass_footprint` | 足迹图表数据（90天） |
| `coinglass_spot_netflow` | 交易所净流量 |
| `coinglass_orderbook_heatmap` | 订单簿深度视觉化 |
### 综合工具
| 工具 | 功能 |
|------|--------|
| `coinglass_full_scan` | **全能** — 9 项指标在一个调用中 |
## 快速开始
### 1. 克隆和安装
```bash
git clone https://github.com/rcz87/McPCG.git
cd McPCG
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
```
### 2. 设置 API 密钥
```bash
cp .env.example .env
nano .env # 输入 COINGLASS_API_KEY
```
### 3. 运行服务器
```bash
# HTTP 模式（适用于远程 claude.ai）
python -m coinglass_mcp.server
# 标准输入/输出模式（适用于本地 Claude Desktop）
MCP_TRANSPORT=stdio python -m coinglass_mcp.server
```
服务器运行在 `http://0.0.0.0:8787/mcp`
### 4. 连接到 Claude
**claude.ai（远程）：**
设置 → 集成 → 添加 MCP 服务器 → URL: `http://您的VPS_IP:8787/mcp`
**Claude Desktop（本地）：**
```json
{
"mcpServers": {
"coinglass": {
"command": "python",
"args": ["-m", "coinglass_mcp.server"],
"cwd": "/path/to/McPCG",
"env": {
"COINGLASS_API_KEY": "您的密钥",
"COINGLASS_PLAN": "标准",
"MCP_TRANSPORT": "stdio"
}
}
}
}
```
## 部署到 VPS
### 一键安装
```bash
# 在 VPS 上：
git clone https://github.com/rcz87/McPCG.git ~/coinglass-mcp
cd ~/coinglass-mcp
bash deploy/setup-vps.sh
```
### 管理命令
```bash
bash deploy/manage.sh start # 启动服务器
bash deploy/manage.sh stop # 停止服务器
bash deploy/manage.sh restart # 重启服务器
bash deploy/manage.sh status # PM2 状态
bash deploy/manage.sh logs # 查看日志
bash deploy/manage.sh update # 拉取 + 重启
bash deploy/manage.sh health # 健康检查
bash deploy/manage.sh tools # 列出工具
```
### HTTPS（可选但推荐）
```bash
bash deploy/setup-nginx.sh yourdomain.com
```
## 技术栈
| 组件 | 版本 |
|-----------|---------|
| Python | >= 3.10 |
| FastMCP | 3.1.1 |
| httpx | >= 0.25.0 |
| tenacity | >= 8.2.0 |
| CoinGlass API | V4 |
## 项目结构
```
McPCG/
├── src/coinglass_mcp/
│ ├── __init__.py # 包
│ ├── config.py # 计划层级、间隔、速率限制
│ ├── client.py # 异步 HTTP 客户端 + 缓存 + 重试
│ └── server.py # FastMCP 服务器 + 18 种工具
├── tests/
│ ├── test_config.py # 配置测试
│ └── test_client.py # 客户端测试
├── deploy/
│ ├── setup-vps.sh # VPS 安装脚本
│ ├── setup-nginx.sh # Nginx + SSL 安装
│ └── manage.sh # 管理命令
├── docs/
│ └── RICOZ-TRADING-CHEATSHEET.md
├── BLUEPRINT-MCP-SERVER.md
├── pyproject.toml
├── .env.example
└── .gitignore
```
## 许可证
MIT
