tradingview-mcp

# 📈 AI 交易智能框架 — MCP 服务器 **适用于 Claude 和 MCP 客户端的最完整的 AI 驱动交易工具包。** 回测 + 实时情绪 + 雅虎财经 + 30+ 技术分析工具 — 全部在一个 MCP 服务器中。 [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.com/) [](https://openclaw.ai) [](https://github.com/atilaahmettaner/tradingview-mcp/releases) [](https://pypi.org/project/tradingview-mcp-server/) [](https://github.com/sponsors/atilaahmettaner) > **⭐ 如果这个工具改善了您的工作流程，请给仓库点赞并考虑 [赞助](https://github.com/sponsors/atilaahmettaner) — 它让项目保持活跃和成长！** <a href="https://github.com/sponsors/atilaahmettaner"> <img src="https://img.shields.io/badge/☕_Coffee_($5)-Sponsor-orange?style=for-the-badge&logo=github-sponsors" alt="Sponsor $5"/> </a> <a href="https://github.com/sponsors/atilaahmettaner"> <img src="https://img.shields.io/badge/🚀_Supporter_($15)-Sponsor-blueviolet?style=for-the-badge&logo=github-sponsors" alt="Sponsor $15"/> </a> <a href="https://github.com/sponsors/atilaahmettaner"> <img src="https://img.shields.io/badge/💎_Pro_($30)-Sponsor-gold?style=for-the-badge&logo=github-sponsors" alt="Sponsor $30"/> </a> --- ## 🎥 框架演示 https://github-production-user-asset-6210df.s3.amazonaws.com/67838093/478689497-4a605d98-43e8-49a6-8d3a-559315f6c01d.mp4 --- ## 🏗️ 架构  --- ## ✨ 为什么选择 tradingview-mcp？ | 功能 | `tradingview-mcp` | 传统设置 | Bloomberg Terminal | |---------|-------------------|--------------------|--------------------| | **设置时间** | 5 分钟 | 数小时（Docker，Conda...） | 数周（合约） | | **成本** | 免费 & 开源 | 可变 | $30k+/年 | | **回测** | ✅ 11 种策略 + 夏普比率（包括做空） | ❌ 手动脚本 | ✅ 专有 | | **实时情绪** | ✅ Reddit + RSS 新闻 | ❌ 单独设置 | ✅ 终端 | | **市场数据** | ✅ 实时 / 实时 | 历史 / 延迟 | 实时 | | **API 密钥** | **不需要** | 多个（OpenAI 等） | 不适用 | --- ## 🆕 分叉新增：自定义策略 此分叉添加了五种使用 Python 和 Pine Script 实现的自定义策略。完整详情见 [`strategies/STRATEGIES.md`](strategies/STRATEGIES.md)。 ### VWMA 17 策略 趋势跟随，带有自适应考夫曼效率比率过滤器。支持做多和做空。使用 VWMA(17) 与 ATR 交叉的止损/止盈。ER 动态选择 SMA(200) 在趋势市场或 SMA(100) 在波动市场。 ### 更高中位策略 多时间框架市场结构策略。通过 3+ 连续更高高点/更高低点在 HTF（4H）上检测趋势，在 LTF（1H）回调确认时进入。在 HTF 结构翻转或趋势耗尽检测器（RSI 背离 + 交易量干枯 + ATR 突增）时退出。可选的跟踪止损，带有可配置的利润阈值。 ### 买入并保护策略 买入并持有，带有下行保护。立即进入做多并像 B&H 一样保持投资，但当 2+ 危险信号同时触发时退出：快速价格下跌（从峰值 8%）、SMA(200) 突破或波动性激增（ATR > 3 倍平均值）。捕获约 86% 的 B&H 回报，同时显著降低回撤。 ### 直线策略 带有 4 点确认的趋势线突破策略。通过摆动点绘制支撑/阻力线，需要 2+ 个额外确认，容差为 1.5%。交易突破，1 个交易日确认。默认仅做多，可选做空。在具有明显趋势反转的资产上效果最佳。 ### 波动率收获策略（新） 适用于波动/波动市场的均值回归。使用考夫曼 ER 检测无方向市场，然后在恐慌下跌时买入，在急剧上涨时做空。ATR Z-Score 进入，交易量确认。三层退出：均值回归、时间限制、止损。 ```bash # VWMA17 python strategies/vwma17_strategy.py --symbol BTC-USD --period 2y # 更高中位策略（默认：结构 + 耗尽退出） python strategies/higher_highs_strategy.py --symbol SPY --period 2y --long-only # 买入并保护（B&H 带有崩溃保护） python strategies/buy_and_protect_strategy.py --symbol SPY --period 2y # 直线（趋势线突破） python strategies/straight_line_strategy.py --symbol SPY --period 2y # 波动率收获（波动市场中的均值回归） python strategies/volatility_harvester_strategy.py --symbol BTC-USD --period 2y ``` `strategies/` 目录包含配对文件 — 相同的策略名称，不同的扩展名： - `.py` — 独立的 Python 回测工具，带有 CLI - `.pine` — TradingView Pine Script v6 等效 --- ## 🚀 快速开始（5 分钟） ### 通过 pip 安装 ```bash pip install tradingview-mcp-server ``` ### Claude 桌面配置 (`claude_desktop_config.json`) ```json { "mcpServers": { "tradingview": { "command": "uvx", "args": ["tradingview-mcp-server"] } } } ``` ### 或从源代码运行 ```bash git clone https://github.com/atilaahmettaner/tradingview-mcp cd tradingview-mcp uv run tradingview-mcp ``` --- ## 📱 通过 Telegram、WhatsApp 等使用（OpenClaw） 使用 [OpenClaw](https://openclaw.ai) 将此服务器连接到 **Telegram、WhatsApp、Discord** 和 20+ 个消息平台。**在 Hetzner VPS（Ubuntu 24.04）上测试和验证。** ### 工作原理 > OpenClaw 将 Telegram 消息路由到 AI 代理。代理使用 `trading.py` — 一个薄的 Python 包装器 — 调用 `tradingview-mcp` 函数并返回格式化结果。**OpenClaw 和服务器之间不需要 MCP 协议；它是一个直接的 Python 导入。** ``` Telegram → OpenClaw 代理（AI 模型）→ trading.py（bash）→ tradingview-mcp → 雅虎财经 ``` ### 快速设置 ```bash # 1. 安装 UV 和 tradingview-mcp curl -LsSf https://astral.sh/uv/install.sh | sh && source ~/.bashrc uv tool install tradingview-mcp-server # 2. 配置 OpenClaw 通道 cat > ~/.openclaw/openclaw.json << 'EOF' { channels: { telegram: { botToken: "YOUR_BOT_TOKEN_HERE", }, }, } EOF # 3. 配置网关 + 代理 openclaw config set gateway.mode local openclaw config set acp.defaultAgent main # 4. 设置您的 AI 模型（选择以下之一） openclaw configure --section model # 5. 安装技能 + 工具包装器 mkdir -p ~/.agents/skills/tradingview-mcp ~/.openclaw/tools curl -fsSL https://raw.githubusercontent.com/atilaahmettaner/tradingview-mcp/main/openclaw/SKILL.md \ -o ~/.agents/skills/tradingview-mcp/SKILL.md curl -fsSL https://raw.githubusercontent.com/atilaahmettaner/tradingview-mcp/main/openclaw/trading.py \ -o ~/.openclaw/tools/trading.py && chmod +x ~/.openclaw/tools/trading.py # 6. 启动网关 openclaw gateway install systemctl --user start openclaw-gateway.service ``` ### 选择您的 AI 模型 OpenRouter **不是必需的** — 使用您拥有的密钥的任意提供商： | 提供商 | OpenClaw 的模型 ID | 获取密钥 | |----------|----------------------|---------| | **OpenRouter** （聚合器 — 访问所有模型） | `openrouter/google/gemini-3-flash-preview` | [openrouter.ai/keys](https://openrouter.ai/keys) | | **Anthropic** （直接克劳德） | `anthropic/claude-sonnet-4-5` | [console.anthropic.com](https://console.anthropic.com) | | **谷歌** （直接宝石） | `google/gemini-2.5-flash` | [aistudio.google.com](https://aistudio.google.com) | | **OpenAI** （直接 GPT） | `openai/gpt-4o-mini` | [platform.openai.com](https://platform.openai.com) | ```bash # 示例 — 设置您选择的模型： openclaw config set agents.defaults.model "openrouter/google/gemini-3-flash-preview" # 通过 OpenRouter openclaw config set agents.defaults.model "anthropic/claude-sonnet-4-5" # 直接通过 Anthropic openclaw config set agents.defaults.model "google/gemini-2.5-flash" # 直接通过谷歌 ``` > ⚠️ **重要：** 前缀必须与您的提供商匹配。`google/...` 需要谷歌 API 密钥。`openrouter/...` 需要 OpenRouter 密钥。 ### ⚠️ 常见错误 | 症状 | 原因 | 修复 | |---------|-------|-----| | `Unrecognized keys: mcpServers` | `mcpServers` 在此版本中不受支持 | 从配置中删除，使用 bash 包装器 | | `No API key for provider "google"` | 使用了 `google/model` 但只有 OpenRouter 密钥 | 改用 `openrouter/google/model` | | `which agent?` 循环 | `acp.defaultAgent` 未设置 | `openclaw config set acp.defaultAgent main` | | 网关无法启动 | `gateway.mode` 丢失 | `openclaw config set gateway.mode local` | ### 测试您的机器人 一旦运行，发送给您的 Telegram 机器人： ``` market snapshot backtest RSI strategy for AAPL, 1 year compare all strategies for BTC-USD ``` 👉 **[完整的 OpenClaw 设置指南 →](OPENCLAW.md)** --- 与基本筛选器不同，该框架部署了 **专门的 AI 代理**，实时辩论发现结果： 1. **🛠️ 技术分析师** — 布林带（±3 专有评级）、RSI、MACD 2. **🌊 情绪和动量分析师** — Reddit 社区情绪 + 价格动量 3. **🛡️ 风险经理** — 波动性、回撤风险、均值回归信号 *输出：`STRONG BUY` / `BUY` / `HOLD` / `SELL` / `STRONG SELL` 带有置信度评分* --- ## 🔧 所有 30+ MCP 工具 ### 📊 回测引擎 *(v0.6.0 新增)* | 工具 | 描述 | |------|-------------| | `backtest_strategy` | 使用机构指标（夏普比率、卡尔玛比率、期望值）回测 11 种策略中的 1 种 | | `compare_strategies` | 在同一交易品种上运行所有策略并按性能排名 | **11 种测试策略：** ([完整详情](strategies/STRATEGIES.md)) - `rsi` — RSI 超卖/超买均值回归 - `bollinger` — 布林带均值回归 - `macd` — MACD 金叉/死叉 - `ema_cross` — EMA 20/50 金叉/死叉 - `supertrend` — 基于 ATR 的超级趋势跟踪 - `donchian` — 唐奇安通道突破（乌龟交易员风格） - `vwma17` — VWMA(17) 交叉与自适应 ER 趋势过滤器（做多 + 做空） - `higher_highs` — 多时间框架市场结构与耗尽检测（做多 + 做空） - `buy_and_protect` — 买入并持有，带有 2+ 信号汇聚崩溃保护（仅做多） - `straight_line` — 带有 4 点确认的趋势线突破（做多 + 可选做空） - `volatility_harvester` — 适用于波动市场的均值回归，带有 ER 状态门控（做多 + 做空） **您获得的指标：** 胜率、总回报、夏普比率、卡尔玛比率、最大回撤、利润因子、期望值、最佳/最差交易，与 **现实佣金 + 滑点模拟**。 ``` 示例提示： "Compare all strategies on BTC-USD for 2 years" → #1 Supertrend: +31.5% | Sharpe: 2.1 | WR: 62% → #2 Bollinger: +18.3% | Sharpe: 3.4 | WR: 75% → Buy & Hold: -5.0% ``` --- ### 💰 雅虎财经 — 实时价格 *(v0.6.0 新增)* | 工具 | 描述 | |------|-------------| | `yahoo_price` | 实时报价：价格、变化百分比、52 周高/低、市况 | | `market_snapshot` | 全球概览：标普 500、纳斯达克、VIX、BTC、ETH、欧元/美元、SPY、GLD | **支持：** 股票（AAPL、TSLA、NVDA...）、加密货币（BTC-USD、ETH-USD、SOL-USD）、ETF（SPY、QQQ、GLD）、指数（^GSPC、^DJI、^IXIC、^VIX）、外汇（EURUSD=X）、土耳其（THYAO.IS、SASA.IS） --- ### 🧠 AI 情绪和智能 *(v0.5.0 新增)* | 工具 | 描述 | |------|-------------| | `market_sentiment` | 跨金融社区的 Reddit 情绪（看涨/看跌评分、热门帖子） | | `financial_news` | 来自路透社、CoinDesk、CoinTelegraph 的实时 RSS 头条新闻 | | `combined_analysis` | **强大工具：** TradingView 技术分析 + Reddit 情绪 + 实时新闻 → 融合决策 | --- ### 📈 技术分析核心 | 工具 | 描述 | |------|-------------| | `get_technical_analysis` | 完整的 TA：RSI、MACD、布林带、23 个指标，带有 BUY/SELL/HOLD | | `get_multiple_analysis` | 批量 TA，适用于多个交易品种 | | `get_bollinger_band_analysis` | 专有 ±3 BB 评级系统 | | `get_stock_decision` | 3 层决策引擎（排名 + 交易设置 + 质量评分） | | `screen_stocks` | 带有 20+ 个过滤标准的跨交易所筛选器 | | `scan_by_signal` | 按信号类型扫描（超卖、趋势、突破...） | | `get_candlestick_patterns` | 15 个烛台模式检测器 | | `get_multi_timeframe_analysis` | 每周 → 每日 → 4H → 1H → 15m 对齐分析 | --- ### 🌍 跨交易所支持 | 交易所 | 工具 | |----------|-------| | **Binance** | 加密货币筛选器，所有交易对 | | **KuCoin / Bybit+** | 加密货币筛选器 | | **NASDAQ / NYSE** | 美国股票（AAPL、TSLA、NVDA...） | | **EGX (埃及)** | `egx_market_overview`、`egx_stock_screener`、`egx_trade_plan`、`egx_fibonacci_retracement` | | **土耳其 (BIST)** | 通过 TradingView 筛选器 | --- ## 💬 示例 AI 对话 ``` 您： "给我一个完整的市场快照" AI： [market_snapshot] → 标普 500 -3.4%，BTC +0.1%，VIX 31 (+13%)，欧元/美元 1.15 您： "Reddit 对 NVDA 说了什么？" AI： [market_sentiment] → 强看涨 (0.41) | 23 篇帖子 | 18 篇看涨 您： "回测 BTC-USD 的 RSI 策略，2 年" AI： [backtest_strategy] → +31.5% 回报 | 100% 胜率 | 2 笔交易 | B&H: -5% 您： "AAPL 在过去 2 年中，哪种策略表现最好？" AI： [compare_strategies] → Supertrend #1 (+14.6%，夏普比率 3.09)，MACD 垫底 (-9.1%) 您： "分析 TSLA 的所有信号：技术 + 情绪 + 新闻" AI： [combined_analysis] → 买入 (技术强买入 + 看涨 Reddit + 积极新闻) ``` --- ## 💖 支持项目 该框架 **免费开源**，在空闲时间构建。如果它为您节省了数小时的研究或帮助您做出更好的决策，请考虑赞助： | 等级 | 每月 | 您获得的 | |------|---------|--------------| | ☕ 咖啡 | $5 | 由衷的感激 + 在 README 中提及您的名字 | | 🚀 支持者 | $15 | 以上 + 优先修复错误 | | 💎 专业版 | $30 | 以上 + 优先请求功能 | <a href="https://github.com/sponsors/atilaahmettaner"> <img src="https://img.shields.io/badge/Become_a_Sponsor-pink?style=for-the-badge&logo=github-sponsors" alt="赞助"/> </a> 每次赞助直接支持新功能，如 Walk-Forward 回测、Twitter/X 情绪分析和管理云托管。 --- ## 📋 路线图 - [x] TradingView 技术分析（30+ 指标） - [x] 跨交易所筛选器（Binance、KuCoin、EGX、美国股票） - [x] Reddit 情绪分析 - [x] 实时财经新闻（RSS） - [x] 雅虎财经实时价格 - [x] 回测引擎（6 种策略 + 夏普/卡尔玛比率/期望值） - [ ] Walk-forward 回测（过拟合检测） - [ ] Twitter/X 市场情绪 - [ ] 模拟交易 - [ ] 云托管（无需本地设置） --- ## 📄 许可证 MIT 许可证 — 参见 [LICENSE](LICENSE) 了解详情。 --- *免责声明：本工具仅用于教育和研究目的。它不构成财务建议。在做出投资决策之前，请始终进行自己的研究。*