📌 项目地址:tradesdontlie/tradingview-mcp | ⭐ 4,733 颗星 | 🔧 JavaScript | 📜 未标注
它解决了什么问题
传统上,要在 TradingView 上分析图表、编写 Pine Script 策略,你需要手动切换窗口、点击菜单、反复修改代码。tradingview-mcp 通过 Model Context Protocol(MCP)将 Claude Code 等 AI 助手直接连接到本地运行的 TradingView Desktop 应用,让你能用自然语言指令完成图表分析、指标调试和工作流自动化。其核心价值不在于“代替”交易员,而是探索 LLM 代理如何理解并操作一个复杂的金融桌面 UI——这是目前 AI 在量化研究中最前沿的落地尝试之一。
该项目不连接 TradingView 的远程服务器,不存储或转发任何市场数据,也不绕过任何付费墙。它依赖 Chrome DevTools Protocol(CDP)——Electron 应用(如 VS Code、Slack)内置的调试接口——与本地 TradingView 实例通信。所有数据处理都在本机完成。
怎么用
使用前需要满足两个硬性条件:
- 拥有有效的 TradingView 订阅,并在本地安装了 TradingView Desktop 应用。
- 显式开启 CDP 调试端口。启动 TradingView Desktop 时附加 Chromium 标志:
tradingview --remote-debugging-port=9222
(具体命令取决于你的操作系统,更多细节参见项目 README 或官方文档)
当 TradingView 在调试模式下运行后,安装并启动 tradingview-mcp 服务。安装方式通常是 npm 全局安装或本地克隆后运行,具体命令请参考项目 README 中的说明(README 未提供完整安装命令,因此以官方文档为准)。启动后,该服务会暴露出 MCP 接口,Claude Code 等 MCP 客户端即可通过自然语言指令与 TradingView 交互。
示例工作流(基于 README 所述的能力):
– “把当前图表的 K 线时间周期改为 4 小时”
– “在副图添加 200 日均线,并标出金叉位置”
– “打开 Pine Editor,新建一个策略:当 RSI 低于 30 且价格低于布林下轨时做多”
– “读取当前持仓的盈亏数据”(如果 TradingView 界面上有显示)
这些指令不需要你手动点击任何按钮——AI 代理通过 CDP 直接操作 TradingView 的 Electron 窗口。
与其他工具的区别
| 对比项 | tradingview-mcp | TradingView 内置策略回测 | 传统交易机器人 |
|---|---|---|---|
| 交互方式 | 自然语言 | 手动编写 Pine Script | 程序化 API |
| 控制对象 | TradingView 桌面 UI 所有元素 | 仅 Pine Script 引擎 | 交易所 API |
| 是否执行真实交易 | 否(仅图表交互) | 否(仅模拟回测) | 是 |
| 技术前提 | Claude Code 订阅、CDP 知识 | 仅需 TradingView 账户 | 服务器、交易所权限 |
| 风险 | 未公开接口可能随更新失效 | 官方支持 | 资金损失风险 |
关键区别在于:tradingview-mcp 不是用程序化接口操作交易,而是像一个人那样“看”屏幕并“点击”按钮。它更适合研究 Pine Script 开发、快速验证策略想法、调试复杂指标,而不是自动化交易。
安全与注意事项
- 数据完全本地:工具不向外部传输任何 TradingView 数据,所有处理都在本机内存中完成。
- 需手动开启调试端口:默认关闭,你主动添加
--remote-debugging-port标志后才会启用。这意味着外部程序无法未经授权访问你的 TradingView。 - 接口不稳定:CDP 访问的是 TradingView 内部未文档化的 Electron 结构。TradingView 的任何桌面版更新都可能破坏这些接口。如果稳定性对你很重要,建议锁定 TradingView Desktop 版本。
- 免责:该项目与 TradingView Inc. 无关,不绕过任何付费限制,只读取和控制你已经安装并登录的桌面应用。
- 学术研究背景:README 明确点出这是对“LLM 代理如何与专业交易界面交互”这一开放问题的探索,不是交易机器人。适合研究人员、量化开发者和高级 Pine Script 用户。