MCP TradingView Server

MCP-Server (Model Context Protocol) in Python, der TradingView-Marktdaten an einen MCP-Client bereitstellt – Claude Desktop, claude.ai oder jeden anderen kompatiblen Client. Die Daten werden über tvdatafeed (OHLCV) und tradingview-ta (Screener) abgerufen.

Verfügbare Tools

tv_get_indicators im Detail

Berechnete Indikatoren: RSI, MACD, Bollinger Bands (mit Squeeze-Erkennung), EMA, SMA, ATR (mit Long/Short-Stop-Levels), Stochastik, ADX (+DI/−DI), OBV, 20-Perioden-Volumendurchschnitt und -Verhältnis sowie Erkennung von RSI-Divergenzen.

Drei standardmäßig deaktivierte Optionen:

Akzepteerte Intervalle: 1, 3, 5, 15, 30, 45 (Minuten), 1H, 2H, 3H, 4H, 1D, 1W, 1M.

Umfang des Screeners

tvdatafeed bietet keine Screener-API. tv_screener durchsucht daher ein hartkodiertes, vordefiniertes Universum in MARKET_SYMBOLS (src/mcp_tradingview/client.py) und berechnet die Indikatoren für jedes Symbol über tradingview-ta:

Die Aufzählung ScreenerMarket akzeptiert auch futures, india, brazil, austra lia, canada, europe und hongkong, aber für diese Märkte ist kein Universum definiert: Der Aufruf gibt eine leere Liste zurück. Es genügt, einen Eintrag in MARKET_SYMBOLS hinzuzufügen, um sie zu aktivieren.

Related MCP server: tradingview-mcp

Architektur

Client MCP (Claude Desktop, claude.ai…)
    │
    ├── stdio ──► process local
    └── SSE   ──► serveur HTTP (Starlette + uvicorn)
              │
              ├──► tvdatafeed    : bougies OHLCV
              └──► tradingview-ta : screener
                        │
                        └──► cache TTL en mémoire

Voraussetzungen

• Python ≥ 3.11

• Ein TradingView-Konto ist optional – der anonyme Zugriff funktioniert, allerdings mit strengeren Ratenbegrenzungen.

• Das MCP-SDK ist auf < 2.0.0 gepinnt: Version 2.x entfernt die Dekoratoren @server.list_tools() / @server.call_tool() und benennt Tool.inputSchema in Tool.input_schema um. Bevor diese Obergrenze angehoben wird, ist eine Migration erforderlich.

Installation

git clone https://github.com/mathieubernardi/tradingview_mcp.git
cd tradingview_mcp

pip install -e ".[dev]"

cp .env.example .env   # puis éditer .env

Konfiguration

Alle Variablen haben das Präfix TV_ und können entweder über eine .env-Datei oder über die Umgebung übergeben werden.

Die doppelte Präfixierung von TV_TV_USERNAME / TV_TV_PASSWORD ist beabsichtigt: Das Umgebungspräfix TV_ wird zu den Feldern tv_username / tv_password hinzugefügt.

Server starten

Zwei äquivalente Einstiegspunkte: das Konsolenskript mcp-tradingview und das Modul python -m mcp_tradingview. Letzteres hängt nicht vom PATH ab, was es unter Windows zuverlässiger macht.

# Linux / macOS — stdio
TV_TRANSPORT=stdio python -m mcp_tradingview

# Linux / macOS — SSE
TV_TRANSPORT=sse python -m mcp_tradingview

# Windows PowerShell — stdio
$env:TV_TRANSPORT = "stdio"; python -m mcp_tradingview

# Windows PowerShell — SSE
$env:TV_TRANSPORT = "sse"; python -m mcp_tradingview

Integration mit Claude Desktop (stdio)

In claude_desktop_config.json einfügen – unter macOS ~/Library/Application Support/Claude/, unter Windows %APPDATA%\Claude\:

{
  "mcpServers": {
    "tradingview": {
      "command": "python",
      "args": ["-m", "mcp_tradingview"],
      "env": {
        "TV_TRANSPORT": "stdio",
        "TV_CACHE_TTL_SECONDS": "60"
      }
    }
  }
}

Wenn die Python-Umgebung nicht die Standard-Umgebung ist, ersetzen Sie "python" durch den absoluten Pfad des Interpreters des virtualenv. Um ein TradingView-Konto zu verwenden, fügen Sie TV_TV_USERNAME und TV_TV_PASSWORD im Block env hinzu.

Im stdio-Modus wird die TradingView-Sitzung erst beim ersten Tool-Aufruf lazy aufgebaut: Der MCP-Handshake antwortet sofort und beim Start tritt für den Client kein Timeout auf.

SSE-Integration

TV_TRANSPORT=sse TV_PORT=8765 python -m mcp_tradingview

Entwicklung

pytest tests/ -v          # tests
ruff check src/ tests/    # lint
mypy src/                 # type checking (strict)

Bekannte Einschränkungen

• tvdatafeed ist ein inoffizieller Client, der auf den Web-Endpunkten von TradingView basiert: Er kann ohne Vorankündigung aufhören zu funktionieren.

• tv_screener durchsucht nicht den gesamten Markt, sondern nur das oben beschriebene vordefinierte Universum.

• Ohne ein Premium-TradingView-Konto können die Daten mehrere Minuten verögert sein.

• Der anonyme Zugriff unterliegt deutlch strengeren Ratenbegrenzungen als ein angemeldetes Konto.

• Fehler eines Tools werden dem Client als JSON {"error": ..., "tool": ..., "arguments": ...} zurückgegeben, statt als Protokollfehler gemeldet zu werden.

Projektstruktur

tradingview_mcp/
├── src/mcp_tradingview/
│   ├── __init__.py      # métadonnées du paquet (__version__)
│   ├── __main__.py      # entrée `python -m mcp_tradingview`
│   ├── config.py        # settings (pydantic-settings, préfixe TV_)
│   ├── models.py        # schémas Pydantic d'entrée / sortie
│   ├── client.py        # client TradingView, indicateurs, cache TTL
│   ├── tools.py         # définition JSON Schema + dispatch des outils
│   └── server.py        # serveur MCP (stdio + SSE) et entrée console
├── tests/
│   └── test_server.py
├── pyproject.toml
├── .env.example
├── .gitignore
├── LICENSE
└── README.md

Lizenz

Unter der MIT-Lizenz veröfentlicht. Siehe Datei LICENSE.