tradingview-mcp
atilaahmettaner/tradingview-mcp加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
想象一个场景:你让 AI 助手分析昨晚的加密市场表现,它却只能给出一堆通用废话——因为它根本拿不到真实的市场数据。这是大多数 AI Agent 面临的共同困境:通用大模型"聪明"但"眼瞎",缺乏实时金融市场数据输入。
TradingView MCP 正是解决这个问题的利器。它是一个基于 Model Context Protocol(MCP)的服务器,将 TradingView 的实时行情、技术指标、选股器、情感分析等 39 种工具无缝接入 AI 助手,让 AI 不再是"无源之水"。
图 1:TradingView MCP 整体架构,AI 通过 MCP 协议与 TradingView 数据层交互
作者 Atila Ahmettaner 是一名量化交易开发者,在尝试让 Claude Desktop 执行专业市场分析时,发现主流方案都需要付费 API 或复杂的 SDK 集成。他的解决方案是:利用 TradingView 本身提供的数据(免费版即有大量功能)构建一个 MCP 服务器。
这个项目迅速在 GitHub 获得了 5000+ stars,GitHub Trending 多次上榜,成为 MCP 生态中金融数据工具的头号选择。其核心理念是:让 AI 代理用和人类分析师相同的工具工作。
项目代码采用经典的路由层 + 服务层分离架构。核心文件 src/tradingview_mcp/server.py 只负责 MCP 协议层面的工具注册和请求路由,所有业务逻辑下沉到 core/services/ 目录。这种设计保证了代码可测试性和可扩展性——每新增一种市场数据源,只需新增一个 service 文件。
项目使用 FastMCP(mcp[cli]>=1.14.0,<2)作为 MCP 协议实现框架,这是 MCP 官方推荐的 Python SDK。依赖层次清晰:
| 依赖包 | 用途 |
|---|---|
tradingview-screener==3.0.0 | 选股器核心,Pinned 到 3.0.0 防止行为漂移 |
tradingview-ta>=3.3.0 | 技术指标计算(RSI、MACD、布林带等) |
pandas>=2 | 数据处理 |
httpx>=0.27 | 异步 HTTP 请求 |
feedparser>=6.0.12 | 情感分析(RSS/Atom 源解析) |
项目提供 39 个 MCP 工具,涵盖以下几大类:
选股器工具:按市值、涨跌幅、技术面筛选股票/期货/加密货币,支持自定义过滤器组合。
技术分析工具:多时间框架(1分钟到1个月)技术指标分析,覆盖主流技术指标(MA、RSI、MACD、BB、Stochastic 等)。
回测工具:提供 walk-forward(前进分析)回测能力,相比传统回测更接近实盘表现评估。
情感分析工具:从 RSS/Atom 源抓取币圈/财经社区舆论数据,结合技术面给出综合判断。
数据查询工具:支持加密货币、股票、外汇、期货多市场实时数据查询。
图 2:多时间框架技术分析展示,可同时查看日线、周线、月线趋势
对于 AI 爱好者而言,最友好的部分是部署极简。项目提供完整的多阶段 Dockerfile 和 docker-compose.yml,核心步骤仅三行命令:
git clone https://github.com/atilaahmettaner/tradingview-mcp.git
cd tradingview-mcp
docker compose up -d
启动后,AI 助手(如 Claude Desktop)只需在 MCP 配置文件中添加服务器地址,即可立即调用全部 39 种市场分析工具。项目还提供了 .env.example 环境变量模板,支持配置 TradingView 账号(部分高级功能需要)和其他可选参数。
硬件需求几乎为零:无需 GPU,512MB+ 内存即可运行。Docker 镜像基于精简的 Python slim 镜像,总大小控制在 200MB 以内。
图 3:Top Gainers 选股结果可视化,支持自定义排序和过滤
项目文档给出了多个场景的接入示例。对于 Claude Desktop 用户,只需编辑 claude_desktop_config.json 添加 MCP 服务器配置即可。连接建立后,AI 可以:
开发者也可以通过 OpenClaw MCP 插件 接入其他支持 MCP 协议的 AI 客户端。
项目并非完美,使用前需注意以下几点:
1. 免费版 TradingView 数据限制:部分高级技术指标和实时数据需要付费账号。免费版用户可使用延迟 15 分钟的数据。
2. 网络依赖:所有数据均来自 TradingView 服务端,若 TradingView 不可用则工具全部失效。不适合需要完全离线运行的场景。
3. 非金融建议免责:项目明确声明所有工具输出不构成投资建议,用户需自行承担交易决策风险。
4. 依赖版本敏感:项目 pyproject.toml 对多个关键依赖进行了精确版本锁定(如 tradingview-screener==3.0.0),升级前需仔细阅读 CHANGELOG。
从 AI + 金融交叉领域的视角看,TradingView MCP 代表了一个重要趋势:用 AI Agent 的"手"去操作专业金融工具,而非训练一个能回答金融问题的模型。前者更灵活、成本更低、可解释性更强。
项目维护活跃(v0.9.0,持续更新)、文档详尽(含 INSTALLATION.md、EXAMPLES.md、CONTRIBUTING.md)、测试覆盖充分,是难得的高质量开源 MCP 项目。如果你正在构建金融类 AI Agent,或想让现有 AI 助手具备市场分析能力,这个项目的 5000+ stars 绝对名副其实。