加密货币AI交易助手

一款集成MCP协议的AI加密货币交易助手,提供实时市场分析、自动化交易信号和投资组合管理功能,适用于个人交易者和量化投资场景。

  • by Gzeu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Gzeu/crypto-mcp-assistant

使用说明

🚀 加密货币MCP助理

人工智能驱动的加密货币交易助手,集成MCP,用于实时市场分析、自动交易信号和投资组合管理。

🌟 快速部署

⚡ 部署到Vercel(单击一次)

立即部署到Vercel以获得实时web应用程序:

📚 完整的Vercel部署指南

🐋 GitHub代码空间

🚀 现场演示

🎯 主要特点

  • 实时分析:持续监控加密货币市场
  • AI交易信号:人工智能为比特币、以太坊、EGLD和山寨币生成信号
  • 投资组合管理:自动跟踪头寸和损益
  • 风险管理:先进的风险管理系统
  • 币安集成:与币安API直接连接,用于现货和期货
  • TradingView警报:与TradingView集成进行技术分析
  • 多时间段分析:跨多个时间段(1m、5m、15m、1h、4h、1d)的分析
  • 自动通知:重要警报的Discord/Telegram通知
  • 罗马尼亚焦点:对MultiversX(EGLD)交易的特别支持🇷🇴
  • ⚡ Vercel部署:一键部署到Vercel

🌍 部署选项

🌐 Web部署(推荐)

🔥 Vercel(最快)

# Option 1: One-click deploy
# Click the "Deploy to Vercel" button above

# Option 2: CLI deploy
npm install -g vercel
git clone https://github.com/Gzeu/crypto-mcp-assistant.git
cd crypto-mcp-assistant
vercel --prod

特征:

  • ✅ 即时部署 (2分钟)
  • ✅ 自动缩放 全球CDN
  • ✅ 演示模式 在没有API密钥的情况下工作
  • ✅ 生产就绪 使用真正的API密钥
  • ✅ 自定义域名 支持
  • ✅ 超文本传输安全协议 默认情况下

🌎 其他平台

💻 地方发展

快速开始

# Clone the repository
git clone https://github.com/Gzeu/crypto-mcp-assistant.git
cd crypto-mcp-assistant

# Run automatic installer
chmod +x install.sh
./install.sh

手动设置

# Install dependencies
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your API keys

# Start the application
python scripts/start_assistant.py --mode full

🐳 Docker部署

# Quick start with Docker
docker-compose up -d

# Access the application
# Dashboard: http://localhost:8501
# API: http://localhost:8000

📱 Web界面功能

🎯 流线型仪表板

  • 📊 市场概述 -实时加密货币价格和市场情绪
  • 🎯 交易信号 -人工智能生成的带有信心评分的买入/卖出信号
  • 💼 投资组合跟踪 -监控头寸、损益和绩效指标
  • 📈 技术分析 -RSI、MACD、布林带、支撑/阻力
  • 🤖 AI 聊天 -与加密货币交易助手互动聊天
  • ⚙️ 配置 -风险管理和交易偏好

🔌 FastAPI后端

  • 📚 自动生成的API文档 在 /docs
  • ⚡ 实时WebSocket 市场动态
  • 📡 RESTful端点 对于所有功能
  • 🔒 CORS已启用 用于web集成
  • 📈 健康监测 以及状态检查

🔗 API终点

核心终点

GET  /                          # Homepage and API info
GET  /health                    # Health check
POST /api/v1/chat              # Chat with AI agent
POST /api/v1/analyze           # Analyze specific symbol
GET  /api/v1/price/{symbol}    # Get current price
GET  /api/v1/market/overview   # Market overview
GET  /api/v1/signals/generate/{symbol} # Generate trading signal

WebSocket

WS   /ws/market-updates         # Real-time market data stream

📈 支持的功能

🤖 AI交易助理

  • 自动化市场分析 实时数据
  • 交易信号生成 最佳入口/出口点
  • 风险评估 以及职位规模建议
  • 多时间段分析 为了获得更好的准确性
  • 自然语言接口 罗马尼亚语和英语

📊 市场分析

  • 技术指标:RSI、MACD、布林带、EMA/SMA
  • 产量分析 以及机构流量跟踪
  • 支撑和阻力 液位识别
  • 市场情绪 分析和恐惧与贪婪指数
  • 多时间段 不同时期的确认

🐎 加密货币支持

主要配对(优先级)

  • 比特币(BTCUSD) -重点放在高级分析上
  • 以太坊(ethusdt) -次要关注DeFi见解
  • 币安币(BNBUSDT) -带有效用分析的交换令牌

Altcoins

  • MultiversX(埃及镑) - 🇷🇴 罗马尼亚特别关注
  • 卡尔达诺(ADAUSDT) -智能合约平台
  • 索拉纳(SOLUSDT) -高性能区块链
  • 波尔卡多特(DOTUSDT) -互操作性协议
  • 链环(LINKUSDT) -Oracle网络
  • 多边形(MATICUSDT) -以太坊扩展
  • 雪崩(AVAXUSDT) -DApps平台

🛡️ 风险管理

  • 头寸调整 基于账户余额和风险承受能力
  • 止损止盈 自动计算
  • 投资组合多元化 跨多个资产
  • 下拉保护 损失限额
  • 票据交易模式 用于安全测试

🔧 配置

环境变量

创建一个 .env 使用API密钥文件:

# Essential for full functionality
GROQ_API_KEY=your_groq_api_key_here
BINANCE_API_KEY=your_binance_api_key
BINANCE_SECRET_KEY=your_binance_secret

# Optional enhancements
DISCORD_BOT_TOKEN=your_discord_bot_token
TELEGRAM_BOT_TOKEN=your_telegram_bot_token

# Risk Management
RISK_PERCENTAGE=2.0
MAX_POSITIONS=5
TRADING_MODE=paper  # Start with paper trading!

交易配置

编辑 config/trading_config.yaml 自定义:

  • 交易策略和时间框架
  • 风险参数和头寸限制
  • 符号偏好和优先级
  • 警报阈值和通知

🤖 使用示例

💬 AI聊天示例

👤 User: "Analizează Bitcoin pentru swing trading"
🤖 AI: "🔍 Bitcoin Analysis: BTC shows strong bullish momentum on 4H timeframe. 
RSI at 67.3 indicates healthy uptrend without being overbought. 
MACD shows bullish crossover with expanding histogram...

Recommendation: BUY at $63,250
Stop Loss: $61,800 (-2.3%)
Take Profit: $65,500 (+3.6%)
Confidence: 85%"

👤 User: "Ce părere ai despre EGLD?"
🤖 AI: "🇷🇴 EGLD Analysis: MultiversX shows strong momentum with breakout 
pattern. Romanian blockchain ecosystem growing. Technical setup 
looks bullish with entry at $32.15..."

📡 API使用示例

# Get market overview
curl https://crypto-mcp-assistant.vercel.app/api/v1/market/overview

# Analyze specific symbol
curl -X POST https://crypto-mcp-assistant.vercel.app/api/v1/analyze \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTCUSDT", "timeframe": "4h"}'

# Chat with AI
curl -X POST https://crypto-mcp-assistant.vercel.app/api/v1/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "What\'s the best entry point for Ethereum?"}'

📊 绩效和指标

回测结果

  • 胜率:历史数据为68%以上
  • 利润因素:1.8+(损益比)
  • 最大跌幅:<12%(风险控制)
  • 夏普比率:1.4+(风险调整后回报)
  • 平均交易持续时间:2.3天(波动交易)

实时性能跟踪

  • 实时损益 计算和显示
  • 性能指标 跨越多个时间段
  • 风险度量 和暴露监测
  • 交易历史 和日记
  • 组合分析 和优化

免责声明:过去的业绩并不能保证未来的业绩。从纸上交易开始。

🔒 安全与安保

⚠️ 安全第一

# ALWAYS start with paper trading
TRADING_MODE=paper

# Use Binance testnet for experiments
BINANCE_TESTNET=true

# Conservative risk settings
RISK_PERCENTAGE=1.0  # Max 1% risk per trade
MAX_POSITIONS=3      # Limit open positions

🔐 API密钥安全

  • 环境变量 对于API密钥(从不在代码中)
  • 只读API密钥 在可能的情况下
  • IP限制 关于交换API
  • 定期按键轮换 出于安全考虑
  • 先测试网 现场交易前

🚨 风险警告

⚠️ 重要免责声明:

  • 此软件用于 仅用于教育目的
  • 加密货币交易涉及 重大财务风险
  • 永远不要投资更多 你输不起
  • 从纸面交易开始 学习系统
  • 这不是财务建议 -做自己的研究(DYOR)
  • 开发商是 不负责任 任何交易损失

🔍 测试

# Run all tests
pytest tests/ -v

# Run with coverage
pytest tests/ -v --cov=src --cov-report=html

# Test specific functionality
pytest tests/test_ai_agent.py -v
pytest tests/test_market_analysis.py -v

🌐 部署环境

🔥 生产(Vercel)

  • 统一资源定位符: https://crypto-mcp-assistant.vercel.app
  • 特性:具有API键的完整人工智能功能
  • 扩展:根据流量自动缩放
  • 监控:内置性能监控

🧪 演示模式(无API键)

  • 模拟数据 用于测试UI/UX
  • 模拟交易信号 基于真实数据
  • 完整界面 功能
  • 非常适合探索 无需设置

💻 发展

  • 热重载 为了快速发展
  • 调试记录 用于故障排除
  • 测试环境 纸上交易
  • 本地数据库 用于开发数据

📚 文档

🌟 特别功能

🇷🇴 MultiversX(EGLD)对焦

特别关注罗马尼亚加密货币:

  • 专用分析算法 针对EGLD进行了优化
  • 罗马尼亚市场事件 监控和警报
  • 社区情感 从罗马尼亚来源追踪
  • 优化交易参数 埃及镑波动
  • 罗马尼亚语支持 聊天界面

🤖 MCP集成

模型上下文协议支持:

  • 灵活的服务器架构 便于扩展
  • 实时数据源 整合
  • 模块化人工智能功能 用于专业分析
  • 插件系统 用于自定义指标
  • 社区扩展 以及捐款

🚀 路线图

🕰️ v1.1(下一版本)

  • [ ] 高级机器学习策略 使用TensorFlow/PyThorch
  • [ ] 多交换支持 (Coinbase Pro、Kraken、KuCoin)
  • [ ] 移动应用 使用React Native
  • [ ] 社交交易 特征和信号共享
  • [ ] 高级回溯测试 有历史数据

🎆 v1.2(未来)

  • [ ] DeFi集成 用于产量农业分析
  • [ ] NFT市场分析 交易信号
  • [ ] 期权交易 策略与分析
  • [ ] 高级投资组合 再平衡算法
  • [ ] 机器学习 模型训练界面

🎇 v2.0(长期愿景)

  • [ ] 算法交易市场 战略
  • [ ] 社区战略共享 和评级系统
  • [ ] 专业交易工具 对于机构
  • [ ] 高级风险管理 蒙特卡洛模拟
  • [ ] AI模型市场 用于自定义指标

🤝 贡献

我们欢迎捐款! 🎉

🚀 快速贡献

# Fork the repository
# Clone your fork
git clone https://github.com/yourusername/crypto-mcp-assistant.git
cd crypto-mcp-assistant

# Create a feature branch
git checkout -b feature/amazing-feature

# Make your changes and commit
git commit -m "Add amazing feature"

# Push and create a Pull Request
git push origin feature/amazing-feature

🎯 贡献领域

  • 🐛 错误修正 以及性能改进
  • 📈 新技术指标 和分析工具
  • 🔗 Exchange集成 (Coinbase、Kraken等)
  • 🤖 AI/ML增强功能 以及新车型
  • 📱 UI/UX改进 以及移动响应能力
  • 📝 文档 和教程
  • 🌍 国际化 和翻译

🏆 认可

贡献者将出现在:

  • 🎆 贡献者名人堂
  • 📜 发行说明 致谢
  • 🐦 社交媒体 退关货物
  • 🎁 特别贡献者徽章

📦 支持与社区

🐛 获得帮助

🌍 社区

🏆 致谢

特别感谢:

📜 许可证

该项目根据 MIT许可证 -看看 许可证 文件以获取详细信息。


🎆 项目统计

🇷🇴 由...制作❤️ 在罗马尼亚 | ⚡ 由AI和MCP提供技术支持 | 🚀 在Vercel上部署

🌟 给我们一颗星 • 🚀 立即部署 • 💬 加入社区

如果这个项目帮助你做出了更好的交易决策,请考虑给它一个⭐ 在GitHub上!