Skip to content
Back to search

TradingAgents-MCPmode

TradingAgents-MCPmode 是一个创新的多智能体交易分析系统,集成了 Model Context Protocol (MCP) 工具,实现了智能化的股票分析和交易决策流程。系统通过多个专业化智能体的协作,提供全面的市场分析、投资建议和风险管理。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/guangxiangdebizi--tradingagents-mcpmode/badge.svg)](/listings/guangxiangdebizi--tradingagents-mcpmode)

HTML

<a href="/listings/guangxiangdebizi--tradingagents-mcpmode"><img src="/api/listings/guangxiangdebizi--tradingagents-mcpmode/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 413 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # TradingAgents-MCPmode
  2. 基于MCP工具的多智能体交易分析系统
  3. ## 🌟 项目概述
  4. **TradingAgents-MCPmode** 是一个创新的多智能体交易分析系统,集成了 Model Context Protocol (MCP) 工具,实现了智能化的股票分析和交易决策流程。系统通过15个专业化智能体的协作,提供全面的市场分析、投资建议和风险管理。
  5. ### 🎯 核心特性
  6. - **🤖 多智能体协作**: 15个专业化智能体分工合作
  7. - **⚡ 并行处理**: 分析师团队采用并行架构,显著提升分析效率
  8. - **🔧 MCP工具集成**: 支持外部数据源和实时信息获取
  9. - **📊 全面分析**: 公司概述、市场、情绪、新闻、基本面、股东结构、产品业务七维度分析
  10. - **💭 智能辩论**: 看涨/看跌研究员辩论机制,可配置辩论轮次
  11. - **⚠️ 风险管理**: 三层风险分析和管理决策,支持动态风险辩论
  12. - **🎛️ 智能体控制**: 前端可动态启用/禁用特定智能体,灵活定制工作流
  13. - **🌀 辩论轮次配置**: 前端实时设置投资和风险辩论轮次,精确控制分析深度
  14. - **🔧 灵活配置**: 通过环境变量控制智能体MCP权限
  15. - **🌍 多市场支持**: 美股(US)、A股(CN)、港股(HK)
  16. - **🗣️ 自然语言**: 支持自然语言查询,无需指定市场和日期
  17. - **📈 实时决策**: 基于最新数据的交易建议
  18. - **🌐 Web前端**: 完整的Streamlit Web界面,支持实时分析和历史管理
  19. ## 🏗️ 系统架构
  20. ### 智能体组织结构
  21. ```
  22. ┌─────────────────────────────────────────────────────────────┐
  23. │ TradingAgents-MCPmode │
  24. ├─────────────────────────────────────────────────────────────┤
  25. │ 📊 分析师团队 (Analysts) - 并行执行 │
  26. │ ├── CompanyOverviewAnalyst (公司概述分析师) │
  27. │ ├── MarketAnalyst (市场分析师) ┐ │
  28. │ ├── SentimentAnalyst (情绪分析师) │ 并行处理 │
  29. │ ├── NewsAnalyst (新闻分析师) │ 6个分析师 │
  30. │ ├── FundamentalsAnalyst(基本面分析师) │ 同时执行 │
  31. │ ├── ShareholderAnalyst (股东分析师) │ │
  32. │ └── ProductAnalyst (产品分析师) ┘ │
  33. ├─────────────────────────────────────────────────────────────┤
  34. │ 🔬 研究员团队 (Researchers) │
  35. │ ├── BullResearcher (看涨研究员) │
  36. │ └── BearResearcher (看跌研究员) │
  37. ├─────────────────────────────────────────────────────────────┤
  38. │ 👔 管理层 (Managers) │
  39. │ ├── ResearchManager (研究经理) │
  40. │ └── Trader (交易员) │
  41. ├─────────────────────────────────────────────────────────────┤
  42. │ ⚠️ 风险管理团队 (Risk Management) │
  43. │ ├── AggressiveRiskAnalyst (激进风险分析师) │
  44. │ ├── SafeRiskAnalyst (保守风险分析师) │
  45. │ ├── NeutralRiskAnalyst (中性风险分析师) │
  46. │ └── RiskManager (风险经理) │
  47. └─────────────────────────────────────────────────────────────┘
  48. ```
  49. ### 🚀 并行化工作流程
  50. ```mermaid
  51. graph TD
  52. %% 用户输入
  53. USER[👤 用户输入<br/>user_query]
  54. %% 第0阶段:公司概述分析师
  55. A0[🏢 公司概述分析师<br/>📥 输入:user_query<br/>📤 输出:company_details + company_overview_report]
  56. %% 第1阶段:分析师并行节点
  57. PARALLEL[⚡ 分析师并行节点<br/>📥 输入:user_query + company_details<br/>🔄 并发执行6个分析师<br/>📤 输出:全部6个分析报告]
  58. %% 并行执行的6个分析师
  59. A1[🔍 市场分析师]
  60. A2[😊 情绪分析师]
  61. A3[📰 新闻分析师]
  62. A4[📊 基本面分析师]
  63. A5[👥 股东分析师]
  64. A6[🏭 产品分析师]
  65. %% 第2阶段:研究员辩论
  66. B1[📈 看涨研究员<br/>📥 输入:user_query + 全部7个分析师报告<br/>📤 输出:看涨论证 + 辩论历史]
  67. B2[📉 看跌研究员<br/>📥 输入:user_query + 全部7个分析师报告 + 辩论历史<br/>📤 输出:看跌论证 + 辩论历史]
  68. %% 第3阶段:管理层
  69. C1[🎯 研究经理<br/>📥 输入:user_query + 全部7个分析师报告 + 完整辩论历史<br/>📤 输出:investment_plan]
  70. C2[💰 交易员<br/>📥 输入:user_query + 全部7个分析师报告 + 辩论历史 + investment_plan<br/>📤 输出:trader_investment_plan]
  71. %% 第4阶段:风险管理团队
  72. D1[🔥 激进风险分析师<br/>📥 输入:全部信息<br/>📤 输出:激进风险观点 + 风险辩论历史]
  73. D2[🛡️ 保守风险分析师<br/>📥 输入:全部信息 + 风险辩论历史<br/>📤 输出:保守风险观点 + 风险辩论历史]
  74. D3[⚖️ 中性风险分析师<br/>📥 输入:全部信息 + 风险辩论历史<br/>📤 输出:中性风险观点 + 风险辩论历史]
  75. D4[🎯 风险经理<br/>📥 输入:全部信息 + 完整风险辩论历史<br/>📤 输出:final_trade_decision]
  76. %% 主要流程连接
  77. USER --> A0
  78. A0 --> PARALLEL
  79. PARALLEL --> B1
  80. B1 --> B2
  81. B2 -.->|辩论循环| B1
  82. B1 --> C1
  83. C1 --> C2
  84. C2 --> D1
  85. D1 -.->|风险辩论循环| D2
  86. D2 -.->|风险辩论循环| D3
  87. D3 -.->|风险辩论循环| D1
  88. D1 --> D4
  89. D2 --> D4
  90. D3 --> D4
  91. %% 并行节点内部连接(虚线表示并发)
  92. PARALLEL -.-> A1
  93. PARALLEL -.-> A2
  94. PARALLEL -.-> A3
  95. PARALLEL -.-> A4
  96. PARALLEL -.-> A5
  97. PARALLEL -.-> A6
  98. %% 样式定义
  99. style USER fill:#f9f9f9,stroke:#333,stroke-width:2px
  100. style A0 fill:#e1f5fe,stroke:#0277bd
  101. style PARALLEL fill:#fff3e0,stroke:#ff8f00,stroke-width:3px
  102. style A1 fill:#e8f5e8,stroke:#4caf50
  103. style A2 fill:#e8f5e8,stroke:#4caf50
  104. style A3 fill:#e8f5e8,stroke:#4caf50
  105. style A4 fill:#e8f5e8,stroke:#4caf50
  106. style A5 fill:#e8f5e8,stroke:#4caf50
  107. style A6 fill:#e8f5e8,stroke:#4caf50
  108. style B1 fill:#e3f2fd,stroke:#1976d2
  109. style B2 fill:#e3f2fd,stroke:#1976d2
  110. style C1 fill:#fff3e0,stroke:#ef6c00
  111. style C2 fill:#fff3e0,stroke:#ef6c00
  112. style D1 fill:#fce4ec,stroke:#c2185b
  113. style D2 fill:#fce4ec,stroke:#c2185b
  114. style D3 fill:#fce4ec,stroke:#c2185b
  115. style D4 fill:#fce4ec,stroke:#c2185b
  116. ```
  117. ### ⚡ 并行化优势
  118. 1. **显著提升效率**: 6个分析师并发执行,总耗时接近最慢分析师的执行时间
  119. 2. **资源优化**: 充分利用系统资源,避免串行等待
  120. 3. **数据一致性**: 每个分析师使用深拷贝状态,避免并发冲突
  121. 4. **结果合并**: 智能合并各分析师的报告和执行历史
  122. #### 在线体验(公网地址)
  123. - 体验地址:`http://47.79.147.241:8501`
  124. - 说明:对外免费开放用于功能体验与演示。
  125. - 注意:请文明使用,务必不要进行任何形式的攻击、压力测试或恶意访问行为,以免影响服务稳定性。
  126. <img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/c557e15a-de1e-4dbe-b619-b8f32a2a91c2" />
  127. ## 🚀 快速开始
  128. ### 环境要求
  129. - Python 3.8+
  130. - 支持的操作系统:Windows、macOS、Linux
  131. ### 安装步骤
  132. 1. **克隆项目**
  133. ```bash
  134. git clone https://github.com/guangxiangdebizi/TradingAgents-MCPmode.git
  135. cd TradingAgents-MCPmode
  136. ```
  137. 2. **安装依赖**
  138. ```bash
  139. pip install -r requirements.txt
  140. ```
  141. 3. **配置环境变量**
  142. ```bash
  143. cp env.example .env
  144. # 编辑 .env 文件,配置你的API密钥和工作流参数
  145. ```
  146. 4. **配置MCP工具**
  147. ```bash
  148. # 编辑 mcp_config.json 文件,配置MCP服务器
  149. ```
  150. ### 🌐 Web前端使用
  151. **推荐使用方式** - 通过Web界面进行交互:
  152. ```bash
  153. streamlit run web_app.py
  154. ```
  155. 然后在浏览器中访问:`http://localhost:8501`
  156. <img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/280599ee-c00a-4c8c-b61f-c786e43cc6d4" />
  157. #### Web前端功能
  158. - **🏠 首页**: 系统概览和快速导航
  159. - **⚙️ 系统配置**: 在线编辑.env和MCP配置
  160. - **🔍 实时分析**: 输入查询并实时监控分析进度
  161. - **🤖 智能体控制**: 动态启用/禁用特定智能体,按团队组织的复选框界面
  162. - **🌀 辩论配置**: 实时调整投资和风险辩论轮次,精确控制分析深度
  163. - **📊 智能体页面**: 按团队查看各智能体的详细分析结果
  164. - **📚 历史报告**: 管理历史会话,支持Markdown、PDF、DOCX导出
  165. #### 🎛️ 前端智能体控制特性
  166. **智能体启用控制**:
  167. - ✅ **分组管理**: 按分析师、研究员、管理层、风险管理四大团队组织
  168. - ✅ **实时选择**: 复选框界面,支持全选/全不选快速操作
  169. - ✅ **动态计数**: 实时显示已启用智能体数量 (如: 已启用 12/15)
  170. - ✅ **智能跳过**: 禁用的智能体会自动跳过,不影响工作流连续性
  171. **辩论轮次配置**:
  172. - 🔄 **投资辩论**: 滑块设置看涨/看跌研究员辩论轮次 (每轮=双方各发言1次)
  173. - ⚖️ **风险辩论**: 滑块设置激进/保守/中性风险分析师辩论轮次 (每轮=三方各发言1次)
  174. - 📊 **实时预览**: 显示当前设置及预计发言次数
  175. - 🚀 **自动应用**: 开始分析时自动应用前端设置,无需手动确认
  176. ### 💻 命令行使用
  177. 如果你偏好命令行方式:
  178. ```bash
  179. python main.py -c "分析苹果公司股票"
  180. ```
  181. #### 交互模式
  182. ```bash
  183. python main.py
  184. ```
  185. 然后按提示输入你的查询,例如:
  186. - "分析特斯拉股票"
  187. - "给我分析一下600036招商银行"
  188. - "分析NVDA的投资价值"
  189. ## 📊 数据流转机制
  190. ### 🎯 关键设计特点
  191. 1. **company_details占位符系统**
  192. - 🏢 **公司概述分析师**首先获取公司基础信息
  193. - 📥 **仅传递给分析师团队**:6个专业分析师都能获得准确的公司背景
  194. - 🚫 **不传递给后续智能体**:研究员及之后的智能体专注于分析报告综合评估
  195. 2. **信息累积效应**
  196. - **第0阶段**:仅用户查询
  197. - **第1阶段**:用户查询 + 公司详细信息(并行处理)
  198. - **第2阶段**:用户查询 + 全部7个分析师报告
  199. - **第3阶段**:用户查询 + 分析师报告 + 辩论历史 + 投资决策
  200. - **第4阶段**:用户查询 + 所有信息 + 风险观点
  201. 3. **双重辩论机制**
  202. - **投资辩论**:看涨 ↔ 看跌研究员循环辩论
  203. - **风险辩论**:激进 ↔ 保守 ↔ 中性风险分析师循环辩论
  204. ### 💡 实际应用示例
  205. **用户输入**:"分析特斯拉股票"
  206. 1. **🏢 公司概述分析师**:获取Tesla Inc.、TSLA、NASDAQ、电动汽车行业等基础信息
  207. 2. **⚡ 分析师并行节点**:6个分析师同时基于准确的"Tesla Inc."信息进行专业分析
  208. 3. **📈 看涨研究员**:综合所有7个专业分析报告,构建Tesla的看涨投资论证
  209. 4. **🎯 风险经理**:基于所有信息和辩论结果,做出Tesla投资的最终风险决策
  210. 这种设计确保了**信息的精准传递**和**逐步精炼**,每个智能体都能在最适合的信息环境中发挥专业能力!
  211. ## 🎯 使用示例
  212. ### 📱 前端操作示例
  213. **场景**: 快速分析苹果公司股票,仅启用核心分析师并设置简化辩论
  214. 1. **启动系统**:
  215. ```bash
  216. streamlit run web_app.py
  217. ```
  218. 2. **配置智能体** (在"🤖 本轮启用智能体"展开):
  219. - ✅ 分析师团队: 全选 (7个智能体)
  220. - ✅ 研究员团队: 仅选择看涨研究员
  221. - ❌ 管理层: 全不选 (快速分析)
  222. - ❌ 风险管理: 全不选 (快速分析)
  223. - 📊 显示: 已启用 8/15
  224. 3. **设置辩论轮次** (在"🌀 辩论轮次设置"展开):
  225. - 🔄 投资辩论轮次: 1轮 (仅看涨研究员发言1次)
  226. - ⚖️ 风险辩论轮次: 0轮 (跳过风险辩论)
  227. 4. **执行分析**:
  228. - 输入: "分析苹果公司股票的投资价值"
  229. - 点击"🚀 开始分析"
  230. - 系统自动应用前端设置并开始执行
  231. 5. **预期结果**:
  232. - ⚡ 快速执行: 仅8个智能体参与,显著减少分析时间
  233. - 📊 核心报告: 获得7份专业分析师报告
  234. - 🎯 投资建议: 看涨研究员基于分析师报告提供投资建议
  235. ### 🎛️ 动态配置优势
  236. - **🚀 快速体验**: 禁用非核心智能体,1-2分钟获得分析结果
  237. - **🔬 深度分析**: 启用全部智能体+多轮辩论,获得完整决策支持
  238. - **🎯 定制化**: 根据分析需求灵活选择智能体组合
  239. - **💡 实时调整**: 无需重启服务,前端实时调整参数
  240. ## 🛠️ 配置说明
  241. ### 环境变量配置
  242. 在 `.env` 文件中配置以下参数:
  243. ```env
  244. # 大模型配置
  245. OPENAI_API_KEY=your_openai_api_key
  246. OPENAI_BASE_URL=https://api.openai.com/v1
  247. MODEL_NAME=gpt-4
  248. # 工作流配置
  249. MAX_DEBATE_ROUNDS=1 # 投资辩论默认轮次(可在前端动态调整)
  250. MAX_RISK_DEBATE_ROUNDS=1 # 风险辩论默认轮次(可在前端动态调整)
  251. DEBUG_MODE=true # 调试模式,显示详细日志
  252. VERBOSE_LOGGING=true # 详细日志输出
  253. # 智能体MCP权限配置
  254. # 分析师团队 - 建议开启MCP以获取实时数据
  255. COMPANY_OVERVIEW_ANALYST_MCP=true
  256. MARKET_ANALYST_MCP=true
  257. SENTIMENT_ANALYST_MCP=true
  258. NEWS_ANALYST_MCP=true
  259. FUNDAMENTALS_ANALYST_MCP=true
  260. SHAREHOLDER_ANALYST_MCP=true
  261. PRODUCT_ANALYST_MCP=true
  262. # 研究员/管理/风险团队 - 建议关闭MCP专注综合分析
  263. BULL_RESEARCHER_MCP=false
  264. BEAR_RESEARCHER_MCP=false
  265. RESEARCH_MANAGER_MCP=false
  266. TRADER_MCP=false
  267. AGGRESSIVE_RISK_ANALYST_MCP=false
  268. SAFE_RISK_ANALYST_MCP=false
  269. NEUTRAL_RISK_ANALYST_MCP=false
  270. RISK_MANAGER_MCP=false
  271. # 任务数量并发限制
  272. MAX_CONCURRENT_ANALYSIS=2 # 同时运行的分析任务数量
  273. ```
  274. > **💡 提示**: 环境变量中的 `MAX_DEBATE_ROUNDS` 和 `MAX_RISK_DEBATE_ROUNDS` 仅为默认值,实际运行时可在前端实时调整。建议设为1以获得快速体验,如需深度分析可在前端增加轮次。
  275. ### MCP工具配置
  276. 在 `mcp_config.json` 文件中配置MCP服务器:
  277. ```json
  278. {
  279. "mcpServers": {
  280. "finance-mcp": {
  281. "disabled": false,
  282. "timeout": 600,
  283. "transport": "streamable_http",
  284. "url": "https://finvestai.top/mcp",
  285. "headers": {
  286. "X-Tushare-Token": "您的tushare令牌"
  287. }
  288. }
  289. }
  290. }
  291. ```
  292. **配置说明**:
  293. - `disabled`: 是否禁用该MCP服务器(false表示启用)
  294. - `timeout`: 请求超时时间(秒),默认600秒
  295. - `transport`: 传输协议,使用 `streamable_http`
  296. - `url`: MCP服务器地址 `https://finvestai.top/mcp`
  297. - `X-Tushare-Token`: 请替换为你的真实 Tushare API Key
  298. > **💡 提示**: 修改配置后,请重启应用或热重载 MCP 客户端使配置生效。
  299. ## 📈 性能优化
  300. ### 并行处理优势
  301. - **原串行架构**: 6个分析师顺序执行,总耗时 = Σ(各分析师耗时)
  302. - **新并行架构**: 6个分析师并发执行,总耗时 ≈ max(各分析师耗时)
  303. - **性能提升**: 理论上可提升5-6倍效率,实际提升取决于各分析师的耗时分布
  304. ### 资源管理
  305. - 使用深拷贝避免状态竞争
  306. - 智能合并执行历史和工具调用记录
  307. - 优化内存使用,避免状态冗余
  308. ## 🤝 贡献指南
  309. 欢迎提交Issue和Pull Request来改进项目!
  310. ## 📄 许可证
  311. 本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。
  312. ---
  313. **TradingAgents-MCPmode** - 让AI智能体团队为你的投资决策保驾护航! 🚀📈
  314. ## 📬 联系方式
  315. - 邮箱:`guangxiangdebizi@gmail.com`
  316. - LinkedIn:[Xingyu Chen](https://www.linkedin.com/in/xingyu-chen-b5b3b0313/)
  317. - Facebook:[个人主页](https://www.facebook.com/profile.php?id=100072282093932)
  318. - Bilibili:[个人空间](https://space.bilibili.com/51239486?spm_id_from=333.1007.0.0)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.