使用说明
🚀 加密货币MCP助理
人工智能驱动的加密货币交易助手,集成MCP,用于实时市场分析、自动交易信号和投资组合管理。
🌟 快速部署
⚡ 部署到Vercel(单击一次)
立即部署到Vercel以获得实时web应用程序:
🐋 GitHub代码空间
🚀 现场演示
- 演示应用程序: https://crypto-mcp-assistant.vercel.app
- API文件: https://crypto-mcp-assistant.vercel.app/api/docs
- 健康检查: https://crypto-mcp-assistant.vercel.app/health
🎯 主要特点
- 实时分析:持续监控加密货币市场
- 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
- 模拟交易信号 基于真实数据
- 完整界面 功能
- 非常适合探索 无需设置
💻 发展
- 热重载 为了快速发展
- 调试记录 用于故障排除
- 测试环境 纸上交易
- 本地数据库 用于开发数据
📚 文档
- 🚀 Vercel部署指南 -完整的部署指南
- 📚 快速入门指南 -5分钟后开始
- 🐳 Docker指南 -完成Docker设置
- 🔧 API文档 -交互式API文档
- ⚙️ 配置指南 -详细配置
- 🧪 测试指导 -测试和开发
🌟 特别功能
🇷🇴 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改进 以及移动响应能力
- 📝 文档 和教程
- 🌍 国际化 和翻译
🏆 认可
贡献者将出现在:
- 🎆 贡献者名人堂
- 📜 发行说明 致谢
- 🐦 社交媒体 退关货物
- 🎁 特别贡献者徽章
📦 支持与社区
🐛 获得帮助
- 🐛 问题: 创建Bug报告
- ✨ 功能请求: 建议功能
- 💬 讨论: 社区论坛
- 📧 电子邮件: pricopgeorge@gmail.com
🌍 社区
🏆 致谢
特别感谢:
- 主控程序 -模型上下文协议
- Groq -闪电般快速的人工智能推理
- LangChain -AI代理框架
- 币安 -加密货币交易所API
- 快速API -现代Python web框架
- 溪流 -快速的web应用程序开发
- 维塞尔 -无缝部署平台
📜 许可证
该项目根据 MIT许可证 -看看 许可证 文件以获取详细信息。
🎆 项目统计
🇷🇴 由...制作❤️ 在罗马尼亚 | ⚡ 由AI和MCP提供技术支持 | 🚀 在Vercel上部署
如果这个项目帮助你做出了更好的交易决策,请考虑给它一个⭐ 在GitHub上!