atilaahmettaner/tradingview-mcp
GitHub: atilaahmettaner/tradingview-mcp
面向 Claude 等 AI 助手的交易分析 MCP 服务器，提供实时行情、技术指标、策略回测和市场情绪分析功能。
Stars: 695 | Forks: 183
# 📈 AI 交易智能框架 — MCP 服务器
**面向 Claude 和 MCP 客户端的最完整 AI 驱动交易工具包。**
回测 + 实时情绪 + Yahoo Finance + 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-production-user-asset-6210df.s3.amazonaws.com/67838093/478689497-4a605d98-43e8-49a6-8d3a-559315f6c01d.mp4
## 🏗️ 架构
## ✨ 为什么选择 tradingview-mcp？
| 功能 | `tradingview-mcp` | 传统配置 | 彭博终端 |
|---------|-------------------|--------------------|--------------------|
| **设置时间** | 5 分钟 | 数小时（Docker、Conda...）| 数周（合同）|
| **成本** | 免费且开源 | 不定 | $30k+/年 |
| **回测** | ✅ 6 种策略 + 夏普比率 | ❌ 手动脚本 | ✅ 专有 |
| **实时情绪** | ✅ Reddit + RSS 新闻 | ❌ 单独配置 | ✅ 终端 |
| **市场数据** | ✅ 实时/真实时间 | 历史/延迟 | 实时 |
| **API 密钥** | **无需** | 多个（OpenAI 等）| 不适用 |
## 🚀 快速开始（5 分钟）
### 通过 pip 安装
```
pip install tradingview-mcp-server
```
### Claude Desktop 配置（`claude_desktop_config.json`）
```
{
"mcpServers": {
"tradingview": {
"command": "uvx",
"args": ["tradingview-mcp-server"]
}
}
}
```
### 或从源码运行
```
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+ 个消息平台 — 一个自托管 AI 网关。**已在 Hetzner VPS（Ubuntu 24.04）上测试验证。**
### 工作原理
```
Telegram → OpenClaw agent (AI model) → trading.py (bash) → tradingview-mcp → Yahoo Finance
```
### 快速设置
```
# 安装 UV and tradingview-mcp
curl -LsSf https://astral.sh/uv/install.sh | sh && source ~/.bashrc
uv tool install tradingview-mcp-server
# 配置 OpenClaw 通道
cat > ~/.openclaw/openclaw.json << 'EOF'
{
channels: {
telegram: {
botToken: "YOUR_BOT_TOKEN_HERE",
},
},
}
EOF
# 配置 gateway + agent
openclaw config set gateway.mode local
openclaw config set acp.defaultAgent main
# 设置您的 AI 模型（选择以下其中一个选项）
openclaw configure --section model
# 安装 skill + tool wrapper
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
# 启动 gateway
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**（Claude 直连）| `anthropic/claude-sonnet-4-5` | [console.anthropic.com](https://console.anthropic.com) |
| **Google**（Gemini 直连）| `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) |
```
# 示例 — 设置您选择的模型：
openclaw config set agents.defaults.model "openrouter/google/gemini-3-flash-preview" # via OpenRouter
openclaw config set agents.defaults.model "anthropic/claude-sonnet-4-5" # Anthropic direct
openclaw config set agents.defaults.model "google/gemini-2.5-flash" # Google direct
```
### ⚠️ 常见错误
| 症状 | 原因 | 修复 |
|---------|-------|-----|
| `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` | 使用机构级指标（夏普比率、卡玛尔比率、期望值）对 6 种策略之一进行回测 |
| `compare_strategies` | 在同一标的上运行全部 6 种策略并按表现排名 |
**可测试的 6 种策略：**
- `rsi` — RSI 超卖/超买均值回归
- `bollinger` — 布林带均值回归
- `macd` — MACD 黄金/死叉
- `ema_cross` — EMA 20/50 黄金/死叉
- `supertrend` — 基于 ATR 的 Supertrend 趋势跟踪 🔥
- `donchian` — 唐奇安通道突破（海龟交易者风格）
**获得的指标：** 胜率、总回报、夏普比率、卡玛尔比率、最大回撤、盈利因子、期望值、最佳/最差交易、相较买入持有，**含真实模拟佣金 + 滑点**。
```
Example prompt: "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%
```
### 💰 Yahoo Finance — 实时价格 *（v0.6.0 新增）*
| 工具 | 描述 |
|------|-------------|
| `yahoo_price` | 实时报价：价格、涨跌幅、52 周高低、市场状态 |
| `market_snapshot` | 全球概览：S&P500、NASDAQ、VIX、BTC、ETH、EUR/USD、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` | 完整技术分析：RSI、MACD、布林带，23 个指标含买入/卖出/持有建议 |
| `get_multiple_analysis` | 批量对多个标的进行技术分析 |
| `get_bollinger_band_analysis` | 专有 ±3 布林带评级系统 |
| `get_stock_decision` | 三层决策引擎（排名 + 交易设置 + 质量分数）|
| `screen_stocks` | 多交易所筛选器，含 20+ 筛选条件 |
| `scan_by_signal` | 按信号类型筛选（超卖、趋势、突破...）|
| `get_candlestick_patterns` | 15 种蜡烛图形态识别器 |
| `get_multi_timeframe_analysis` | 周线→日线→4H→H→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 对话示例
```
You: "Give me a full market snapshot right now"
AI: [market_snapshot] → S&P500 -3.4%, BTC +0.1%, VIX 31 (+13%), EUR/USD 1.15
You: "What is Reddit saying about NVDA?"
AI: [market_sentiment] → Strongly Bullish (0.41) | 23 posts | 18 bullish
You: "Backtest RSI strategy on BTC-USD for 2 years"
AI: [backtest_strategy] → +31.5% return | 100% win rate | 2 trades | B&H: -5%
You: "Which strategy worked best on AAPL in the last 2 years?"
AI: [compare_strategies] → Supertrend #1 (+14.6%, Sharpe 3.09), MACD last (-9.1%)
You: "Analyze TSLA with all signals: technical + sentiment + news"
AI: [combined_analysis] → BUY (Technical STRONG BUY + Bullish Reddit + Positive news)
```
## 📋 路线图
- [x] TradingView 技术分析（30+ 指标）
- [x] 多交易所筛选器（Binance、KuCoin、EGX、美股）
- [x] Reddit 情绪分析
- [x] 实时财经新闻（RSS）
- [x] Yahoo Finance 实时价格
- [x] 回测引擎（6 种策略 + 夏普/卡玛尔/期望值）
- [ ] Walk-forward 回测（过拟合检测）
- [ ] Twitter/X 市场情绪
- [ ] 模拟交易
- [ ] 托管云服务（无需本地配置）
## 📄 许可证
MIT 许可证 — 详见 [LICENSE](LICENSE)。
*免责声明：此工具仅供教育和研究目的，不构成金融建议。做出投资决策前请始终进行自己的研究。*
标签：AI助手, Binance, Bybit, Claude Desktop, DNS解析, KuCoin, K线形态, MCP服务器, Python, Reddit情绪, TradingView, Yahoo Finance, 交易工具箱, 加密货币, 回测引擎, 多交易所支持, 实时行情, 市场筛选, 布林带, 开源项目, 情绪分析, 技术分析, 技术指标, 无后门, 股票分析, 量化交易, 金融科技