Crypto Currency Server

为 Kiro/Claude 提供币安和 CoinGecko API 的 MCP (Model Context Protocol) 服务器

License: MIT Python 3.8+

---

✨ 特性

• � 统一服务器架构 - 同时支持 REST API 和 MCP 协议
• 📊 币安 API - 现货/合约价格、资金费率、技术分析、Alpha 代币
• 🪙 CoinGecko API - 价格查询、热门币种、币种搜索
• 🔒 HTTPS 支持 - Let's Encrypt 自动证书
• 🌐 免费域名 - DuckDNS 集成
• 🔧 易于部署 - 一键部署脚本

---

� 包含的服务

1. Binance MCP

币安交易所全功能数据分析服务器（模块化架构）

核心功能：

类别	功能
价格查询	现货/合约价格、24小时行情、批量查询
K线分析	K线数据、形态识别（十字星、锤子线等）
技术分析	RSI、MACD、布林带、支撑阻力位
合约分析	资金费率、现货合约价差、套利机会
Alpha代币	实时空投、竞赛追踪、价值分析
市场数据	交易对搜索、涨跌幅排行

2. CoinGecko MCP

获取加密货币市场数据，支持所有主流币种

核心功能：

• 实时价格查询（BTC、ETH、BNB 等）
• 7日涨跌概率分析
• 热门币种查询
• 币种搜索

---

🚀 快速开始

方式 1：远程服务器（推荐）

# 1. 部署到服务器
scp -r ./* root@YOUR_SERVER:/opt/mcp-crypto-api/
ssh root@YOUR_SERVER "cd /opt/mcp-crypto-api && ./quick_deploy.sh"

# 2. 配置 Kiro
cat > ~/.kiro/settings/mcp.json << 'EOF'
{
  "mcpServers": {
    "binance-remote": {
      "type": "http",
      "url": "https://your-domain.duckdns.org/mcp"
    },
    "coingecko-remote": {
      "type": "http",
      "url": "https://your-domain.duckdns.org/mcp-coingecko"
    }
  }
}
EOF

# 3. 重启 Kiro 并测试

方式 2：本地运行

# 1. 安装依赖
pip install -r requirements.txt

# 2. 启动服务器
python3 unified_server.py

# 3. 配置 Kiro（本地）
{
  "binance-local": {
    "command": "python3",
    "args": ["-m", "binance_mcp"],
    "cwd": "/path/to/project"
  }
}

---

� 文档

文档	说明
DEPLOYMENT_GUIDE.md	部署指南（快速开始）
SSL_SETUP_GUIDE.md	SSL 完整配置（DuckDNS、证书、隧道）
LOCAL_WORKFLOW.md	本地开发工作流
完整部署文档.md	详细部署文档（架构、原理）
MCP_DEVELOPMENT_GUIDE.md	MCP 开发指南
QUICK_START.md	三步快速部署
CHANGELOG.md	更新日志

---

🛠️ 项目结构

.
├── binance_mcp/              # 币安 MCP 模块（模块化包）
│   ├── __init__.py
│   ├── api.py               # API 调用
│   ├── analysis.py          # 技术分析
│   ├── alpha.py             # Alpha 代币
│   └── server.py            # MCP 服务器
├── coingecko_mcp.py         # CoinGecko MCP 服务
├── unified_server.py        # 统一服务器（REST + MCP）
├── mcp_http_server.py       # HTTP 服务器（旧版）
├── setup_ssl_for_duckdns.sh # SSL 配置脚本
├── check_dns.sh             # DNS 检查工具
├── start_tunnel.sh          # SSH 隧道启动
├── quick_deploy.sh          # 快速部署脚本
└── requirements.txt         # Python 依赖

---

🔧 配置示例

远程 MCP（HTTPS）

{
  "mcpServers": {
    "binance-remote": {
      "type": "http",
      "url": "https://tager.duckdns.org/mcp",
      "description": "Binance API"
    }
  }
}

SSH 隧道

# 启动隧道
ssh -f -N -L 8443:localhost:443 root@YOUR_SERVER

# 配置
{
  "url": "https://localhost:8443/mcp"
}

---

📊 使用示例

在 Kiro 中询问：

你：BNB现价多少？
Kiro：BNB 当前价格为 $692.50

你：分析 BTC 的技术指标
Kiro：[调用 comprehensive_analysis 工具]
      BTC 技术分析：
      - RSI: 65.2（中性偏多）
      - MACD: 金叉信号
      - 布林带: 价格接近上轨
      ...

你：有哪些 Alpha 空投正在进行？
Kiro：[调用 get_realtime_alpha_airdrops 工具]
      当前进行中的空投：
      1. TIMI - 总价值 $12,500
      2. H - 总价值 $8,900
      ...

---

🔄 更新部署

# 方式 1：使用部署脚本
./deploy_simple.sh

# 方式 2：手动部署
rsync -avz ./* root@YOUR_SERVER:/opt/mcp-crypto-api/
ssh root@YOUR_SERVER "supervisorctl restart mcp-crypto-api"

# 方式 3：使用 Git
git push
ssh root@YOUR_SERVER "cd /opt/mcp-crypto-api && git pull && supervisorctl restart mcp-crypto-api"

---

🐛 故障排查

# 查看服务状态
ssh root@YOUR_SERVER
sudo systemctl status mcp-crypto-api

# 查看日志
sudo journalctl -u mcp-crypto-api -n 50

# 重启服务
sudo systemctl restart mcp-crypto-api

# 测试 API
curl https://your-domain.duckdns.org/health

---

📝 许可证

MIT License

---

� 致谢

• Anthropic - MCP 协议
• Binance - 币安 API
• CoinGecko - CoinGecko API
• DuckDNS - 免费域名服务
• Let's Encrypt - 免费 SSL 证书

---

快速链接：

• 📖 部署指南
• 🔒 SSL 配置
• 💻 本地开发
• 📚 完整文档