convez.ai
MCP ServerFinanceiroIntermediário
hmatrades

Claude TradingView MCP

hmatrades/claude-tradingview-mcp

Analise seus gráficos TradingView com Claude, 100% read-only e seguro

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que permite ao Claude analisar gráficos do TradingView desktop via AppleScript, capturando screenshots e extraindo indicadores técnicos. Construído com segurança de leitura — sem ferramentas de escrita, sem capacidade de executar trades, com verificações de segurança na inicialização.

Instalação

$npx convez-ai hmatrades/claude-tradingview-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 2 meses
Versão
—
Issues abertas
3
Contribuidores
1

Casos de uso

  • Análise técnica em tempo real de gráficos com indicadores (RSI, MACD, EMA, Bollinger)
  • Interpretação natural de padrões e setups de trading antes de decidir manualmente
  • Monitoramento de watchlists e configurações de alertas sem risco de execução acidental

Veredito

Projeto robusto e bem pensado em segurança — oferece análise técnica real sem janelas de risco. Ideal para traders que querem segunda opinião do Claude sem exposição operacional. Requer macOS e TradingView desktop.

README

A tradução para o português deste README ainda está na fila.

claude-tradingview-mcp

Let Claude see your TradingView charts. Never let it trade them.

read-only by construction license: MIT MCP platform: macOS python zero write tools

An MCP server that lets Claude analyze the chart you're looking at in the TradingView desktop app — by reading the window with AppleScript and screenshotting it. It has no order tools, no alert-write tools, no money-movement tools, and it refuses to boot if anyone adds one.


2. Demo

GIF placeholder: docs/media/demo.gif — Claude Desktop receiving a screenshot_chart() of an AAPL daily, then calling extract_indicators() and giving a plain-language read. (Record a 12–20s loop: ask "what's on my screen?" → Claude shows the chart back + the RSI/EMA/MACD read.)

3. Install

# 1) install the server (pipx keeps it isolated)
pipx install claude-tradingview-mcp        # or: uv tool install claude-tradingview-mcp

# 2) register it with Claude
claude mcp add tradingview claude-tradingview-mcp

Then grant macOS Accessibility + Screen Recording to the app running the server (Terminal / Claude Desktop) — see docs/install.md.

4. Quickstart

Drop the snippet from examples/claude-desktop-config.json into your Claude Desktop config, chart any symbol in TradingView, and ask:

"What's on my screen?"

Claude calls get_symbol() → screenshot_chart() → extract_indicators() and tells you what it sees.

5. Why

Claude can already analyze prose. Now it can analyze your charts — the exact ones on your screen, with your indicators and your layout. The chart stays on your machine: the screenshot is captured from your window, handed to Claude, and the temp file is deleted immediately. Nothing is uploaded by this tool, and nothing it exposes can place a trade.

6. The tools (all read-only)

ToolWhat it returns
get_symbol()the charted symbol + timeframe (from the window title)
screenshot_chart()a base64 PNG of only the TradingView window
extract_indicators()RSI, EMA20/50/200, MACD, ATR, Bollinger, VWAP, Supertrend + a verdict
get_watchlist()symbols TradingView currently exposes
read_alerts()read-only view of visible alert configs
resource tradingview://currentcurrent symbol + open windows snapshot

Tools this server will never have

place_order · modify_alert · paper_trade · withdraw · buy · sell · cancel_order · close_position · transfer — registration of any of these raises at boot. See safety.py and tests/test_safety.py.

7. Demo video

Placeholder: a 60-second screencast (link here). Show the boot-time safety abort when a write tool is added — that's the moment that sells the project.

8. FAQ

Will it ever execute a trade? No. There is no code path that can. Tools are registered through a hardcoded allowlist in safety.py; any tool whose name even contains a trade/write verb raises SafetyViolation before the server starts. The test suite asserts the registry is exactly the five read-only tools.

Does my chart get uploaded anywhere? The screenshot is captured locally and deleted from disk right after it's encoded. This tool uploads nothing. (Your MCP client — Claude — receives the image to analyze; that's the point.)

Does it work on Windows/Linux? Not yet — it relies on macOS AppleScript + screencapture. PRs welcome for a Windows/Linux read path, as long as they stay read-only.

Do I need a TradingView API key / paid plan? No. There is no TradingView API here — it reads the desktop app's window. Indicator math uses free public OHLC from yfinance.

9. Comparison

claude-tradingview-mcpccxt MCP serverstradingview-screener
Reads your actual on-screen chart✅❌❌
Can place orders❌ never✅ (that's the point)❌
Needs API keys / exchange creds❌✅❌
Screenshot of your live window✅❌❌
Indicator bundle✅ (local, MIT)variesscanner-based
Safety modelread-only by constructionyou hold the keysread-only

10. Contributing

PRs welcome — with one hard rule: we will not merge any PR that adds a write tool (orders, alert mutation, money movement, "just paper trading", anything). The CI safety test will fail it, and so will we. See docs/threat-model.md.

11. License & sponsors

MIT © 2026 Aiden Hecker. See LICENSE. Indicator formulas are pure pandas (no AGPL dependency). If this saves you time, sponsorship keeps it maintained.

12. Requirements

macOS · TradingView desktop app · Python 3.10+ · Accessibility + Screen Recording permission for the host app. How it works: docs/how-it-works.md.


Ver o original no GitHub

Bom para

Relacionados