Servidor MCP TradingView

Servidor MCP (Model Context Protocol) en Python que expone los datos de mercado TradingView a un cliente MCP — Claude Desktop, claude.ai o cualquier otro cliente compatible. Los datos se obtienen mediante tvdatafeed (OHLCV) y tradingview-ta (screener).

Herramientas expuestas

tv_get_indicators en detalle

Indicadores calculados: RSI, MACD, Bollinger Bands (con detección de squeeze), EMA, SMA, ATR (con niveles de stop largo/corto), Estocástico, ADX (+DI/−DI), OBV, media y ratio de volumen de 20 períodos, y detección de divergencias RSI.

Tres opciones desactivadas por defecto:

Intervalos aceptados: 1, 3, 5, 15, 30, 45 (minutos), 1H, 2H, 3H, 4H, 1D, 1W, 1M.

Alcance del screener

tvdatafeed no expone una API de screener. Por tanto, tv_screener recorre un universo predefinido en código en MARKET_SYMBOLS (src/mcp_tradingview/client.py) y calcula los indicadores en cada símbolo mediante tradingview-ta:

La enumeración ScreenerMarket también acepta futures, india, brazil, australia, canada, europe y hongkong, pero no hay ningún universo definido para esos mercados: la llamada devuelve una lista vacía. Añadir una entrada en MARKET_SYMBOLS basta para activarlos.

Related MCP server: tradingview-mcp

Arquitectura

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

Requisitos previos

• Python ≥ 3.11

• Una cuenta TradingView es opcional: el acceso anónimo funciona, con límites de tasa más estrictos.

• El SDK MCP está fijado en < 2.0.0: la versión 2.x elimina los decoradores @server.list_tools() / @server.call_tool() y renombra Tool.inputSchema a Tool.input_schema. Se necesita una migración antes de levantar este límite.

Instalación

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

pip install -e ".[dev]"

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

Configuración

Todas las variables tienen el prefijo TV_ y pueden pasarse mediante un archivo .env o mediante el entorno.

El doble prefijo de TV_TV_USERNAME / TV_TV_PASSWORD es intencionado: el prefijo de entorno TV_ se añade a los campos tv_username / tv_password.

Iniciar el servidor

Dos puntos de entrada equivalentes: el script de consola mcp-tradingview y el módulo python -m mcp_tradingview. El segundo no depende del PATH, lo que lo hace más fiable en Windows.

# 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

Integración con Claude Desktop (stdio)

Añadir en claude_desktop_config.json — ~/Library/Application Support/Claude/ en macOS, %APPDATA%\Claude\ en Windows:

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

Si el entorno Python no es el predeterminado, reemplazar "python" por la ruta absoluta del intérprete del virtualenv. Para usar una cuenta de TradingView, añadir TV_TV_USERNAME y TV_TV_PASSWORD en el bloque env.

En modo stdio, la sesión de TradingView se establece de forma perezosa en la primera llamada a una herramienta: el handshake MCP responde inmediatamente y el cliente no sufre un timeout al iniciar.

Integración SSE

TV_TRANSPORT=sse TV_PORT=8765 python -m mcp_tradingview

Desarrollo

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

Limitaciones conocidas

• tvdatafeed es un cliente no oficial que se apoya en los endpoints web de TradingView: puede dejar de funcionar sin previo aviso.

• tv_screener no escanea un mercado completo, solo el universo predefinido descrito anteriormente.

• Sin una cuenta Premium de TradingView, los datos pueden tener un retraso de varios minutos.

• El acceso anónimo sufre límites de tasa considerablemente más estrictos que una cuenta conectada.

• Los errores de una herramienta se devuelven al cliente en formato JSON {"error": ..., "tool": ..., "arguments": ...} en lugar de elevarse como errores de protocolo.

Estructura del proyecto

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

Licencia

Distribuido bajo licencia MIT. Ver el archivo LICENSE.