MCPInstall
tradingagents-mcp logo

tradingagents-mcp

by AlataChan 20 stars AlataChan/tradingagents-mcp

modified tradingagents open source project, convert to free data source and add MCP

READMEmain

TradingAgents 混合版本 - 智能股票分析系统

🚀 基于多数据源容错的智能交易分析框架

一个经过深度优化的股票分析系统,具备多层数据源备用机制、成本控制和生产级稳定性。

GitHub Python License


🌟 项目特色

💰 成本优化

  • 免费数据源优先:Yahoo Finance → AkShare → Alpha Vantage
  • 智能降级:付费API仅作最后备用
  • 月成本控制:预估运营成本 ≤ $20/月

🛡️ 生产级稳定性

  • 多层容错机制:3层数据源自动切换
  • 智能重试逻辑:网络错误自动恢复
  • 缓存优化:减少API调用,提升响应速度
  • 错误隔离:单点故障不影响整体分析

🌍 多市场支持

  • 美股:NASDAQ、NYSE 全覆盖
  • A股:沪深两市实时数据
  • 港股:恒生指数成分股
  • 期货:商品期货和金融期货

⚡ 高性能架构

  • 并发处理:多数据源并行获取
  • 智能缓存:SQLite本地缓存机制
  • 流式分析:实时数据流处理
  • 模块化设计:易于扩展和维护

🚀 快速开始

环境要求

  • Python 3.8+
  • 8GB+ RAM 推荐
  • 稳定的网络连接

安装步骤

  1. 克隆项目
git clone https://github.com/AlataChan/tradingagents-mcp.git
cd tradingagents-mcp
  1. 创建虚拟环境
conda create -n tradingagents python=3.8
conda activate tradingagents
  1. 安装依赖
pip install -r requirements_hybrid.txt
  1. 配置环境变量
cp env.template .env
# 编辑 .env 文件,填入您的API密钥

必需的API密钥

# OpenAI API (必需)
OPENAI_API_KEY="sk-..."

# Alpha Vantage API (免费,推荐)
ALPHA_VANTAGE_KEY="..."

# FinnHub API (可选,付费备用)
FINNHUB_API_KEY="..."

运行示例

# 分析单只股票
python main_hybrid.py AAPL

# 分析多只股票
python main_hybrid.py AAPL MSFT GOOGL

📊 系统架构

数据流架构

graph TD
    A[用户请求] --> B[混合配置管理器]
    B --> C[数据获取层]
    C --> D[Yahoo Finance]
    C --> E[AkShare]
    C --> F[Alpha Vantage]
    D --> G[数据融合]
    E --> G
    F --> G
    G --> H[分析引擎]
    H --> I[决策输出]

容错机制

graph LR
    A[Yahoo Finance] -->|失败| B[AkShare]
    B -->|失败| C[Alpha Vantage]
    C -->|失败| D[缓存数据]
    A -->|成功| E[数据融合]
    B -->|成功| E
    C -->|成功| E
    D -->|成功| E

🔧 配置选项

混合配置模式

模式描述月成本适用场景
free仅免费数据源$0个人研究
balanced免费+少量付费$20小团队
premium全功能模式$100+商业应用

自定义配置

from tradingagents.hybrid_config import HybridConfig

config = HybridConfig(
    mode="balanced",
    cache_ttl_hours=6,
    max_retries=3,
    concurrent_requests=3,
    enable_akshare=True,
    enable_alpha_vantage=True
)

📈 使用示例

Python API

from tradingagents.hybrid_config import HybridConfig
from main_hybrid import HybridTradingEngine

# 初始化引擎
config = HybridConfig(mode="balanced")
engine = HybridTradingEngine(config)

# 分析股票
result = engine.analyze_stock("AAPL")
print(f"决策: {result['decision']}")
print(f"置信度: {result['confidence']}")
print(f"数据源: {result['data_sources']}")

Web界面

# 启动Web界面
streamlit run web_streamlit_app.py

批量分析

# 批量分析多只股票
symbols = ["AAPL", "MSFT", "GOOGL", "AMZN"]
results = engine.batch_analyze(symbols)

for symbol, result in results.items():
    print(f"{symbol}: {result['decision']} ({result['confidence']}%)")

🛠️ 核心功能

1. 智能数据获取

  • 自动降级:主数据源失败时自动切换
  • 数据验证:确保数据质量和完整性
  • 实时监控:数据源健康状态监控

2. 多维度分析

  • 基本面分析:财务指标、估值模型
  • 技术分析:MACD、RSI、布林带等指标
  • 情感分析:新闻情感、社交媒体情绪
  • 宏观分析:经济指标、行业趋势

3. 风险管理

  • 波动率分析:历史波动率和隐含波动率
  • 相关性分析:资产间相关性计算
  • 压力测试:极端市场情况模拟
  • 仓位管理:动态仓位调整建议

4. 决策支持

  • 多因子模型:综合多个分析维度
  • 置信度评估:决策可靠性量化
  • 情景分析:不同市场情况下的表现预测
  • 回测验证:历史数据验证策略有效性

📊 性能指标

系统性能

  • 响应时间:45-75秒/股票
  • 成功率:99.5%+(多数据源保障)
  • 并发能力:支持3个并发请求
  • 缓存命中率:85%+

数据覆盖

  • 美股:8000+ 股票
  • A股:4000+ 股票
  • 港股:2000+ 股票
  • 更新频率:实时/日内

🔍 故障排除

常见问题

Q: 为什么分析速度较慢? A: 系统优先使用免费数据源,可能需要多次重试。可以升级到付费模式提升速度。

Q: 如何提高数据准确性? A: 配置多个数据源API密钥,启用数据交叉验证功能。

Q: 系统支持哪些股票市场? A: 目前支持美股、A股、港股,未来将扩展到更多市场。

日志分析

# 查看详细日志
tail -f logs/trading_analysis.log

# 错误日志过滤
grep "ERROR" logs/trading_analysis.log

🤝 贡献指南

我们欢迎社区贡献!请遵循以下步骤:

  1. Fork 项目
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

开发环境设置

# 安装开发依赖
pip install -r requirements_dev.txt

# 运行测试
pytest tests/

# 代码格式化
black tradingagents/

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。


⚠️ 免责声明

本系统仅用于研究和教育目的。交易决策应基于您自己的分析和风险承受能力。我们不对任何投资损失承担责任。

投资有风险,入市需谨慎。


📞 联系我们


🙏 致谢

感谢以下开源项目的支持:


⭐ 如果这个项目对您有帮助,请给我们一个星标!

Made with ❤️ by TradingAgents Community