TradingView MCP Bridge

Asistente personal de IA para los gráficos de tu TradingView Desktop. Conecta Claude Code con tu aplicación de TradingView en ejecución local mediante Chrome DevTools Protocol para análisis de gráficos asistidos por IA, desarrollo de Pine Script y automatización de flujos de trabajo.

[!WARNING] Esta herramienta no está afiliada, respaldada ni asociada con TradingView Inc. Interactúa con tu aplicación de TradingView Desktop que se ejecuta localmente a través de Chrome DevTools Protocol. Revisa el Descargo de responsabilidad antes de usarla.

[!IMPORTANT] Se requiere una suscripción válida de TradingView. Esta herramienta no elude ni evita ningún muro de pago o control de acceso de TradingView. Solo lee y controla la aplicación de TradingView Desktop que ya se está ejecutando en tu equipo.

[!NOTE] Todo el procesamiento de datos se realiza localmente en tu máquina. Ningún dato de TradingView se transmite, almacena ni redistribuye externamente mediante esta herramienta.

[!CAUTION] Esta herramienta accede a APIs internas no documentadas de TradingView a través de la interfaz de depuración de Electron. Estas pueden cambiar o fallar sin previo aviso en cualquier actualización de TradingView. Mantén fija la versión de tu TradingView Desktop si la estabilidad es importante para ti.

Cómo funciona (y por qué es seguro ejecutarlo)

Esta herramienta no se conecta a los servidores de TradingView, no modifica ningún archivo de TradingView ni intercepta tráfico de red. Se comunica exclusivamente con tu instancia de TradingView Desktop en ejecución local a través de Chrome DevTools Protocol (CDP), una interfaz de depuración estándar integrada en todas las aplicaciones Chromium/Electron, como VS Code, Slack y Discord.

El puerto de depuración está deshabilitado por defecto y debe habilitarse explícitamente usando un flag estándar de Chromium (--remote-debugging-port=9222). Nada ocurre sin ese paso deliberado.

Related MCP server: TradingView MCP Bridge

Qué no hace esta herramienta

• Conectarse a los servidores o APIs de TradingView.

• Almacenar, transmitir o redistribuir ningún dato de mercado.

• Funcionar sin una suscripción válida de TradingView y la aplicación de escritorio instalada.

• Burlar ningún muro de pago ni restricción de acceso de TradingView.

• Ejecutar operaciones reales (solo interacción con el gráfico).

• Funcionar si TradingView cambia su estructura interna de Electron.

Contexto de investigación

Este proyecto explora una pregunta abierta de investigación: ¿cómo pueden interactuar los agentes basados en LLM con interfaces de trading profesionales para apoyar la toma de decisiones humana?

En concreto, investiga:

• cómo las APIs estructuradas de herramientas (MCP) pueden conectar los LLM con aplicaciones financieras de escritorio con estado.

• qué límites de latencia, contexto y fiabilidad surgen cuando un agente opera con datos de gráficos en directo.

• cómo manejan los agentes los estados ambiguos de UI financiera (p. ej., interpretar la salida de Pine Script, leer tablas de indicadores).

• si el lenguaje natural es una interfaz eficaz para la navegación por gráficos y el desarrollo de Pine Script.

• los modos de fallo de los agentes LLM en entornos de datos en tiempo real.

Esto no es un bot de trading. Es una capa de interfaz que hace que una aplicación de trading sea legible para un agente LLM, lo que permite a investigadores y desarrolladores estudiar la colaboración humano-IA en flujos de trabajo financieros.

Consulta RESEARCH.md para preguntas abiertas, hallazgos y trabajo relacionado.

Requisitos previos

• La aplicación TradingView Desktop (se requiere suscripción de pago para datos en tiempo real).

• Node.js 18+

• Claude Code con soporte para MCP (para las herramientas MCP) o cualquier terminal (para la CLI).

• macOS, Windows o Linux

Qué hace

Da a tu asistente de IA ojos y manos sobre tu propio gráfico:

• Desarrollo de Pine Script — escribe, inyecta, compila, depura e itera en los guiones con ayuda de IA.

• Navegación de gráficos — cambia símbolos, marcos temporales, zoom a fechas, añadir/eliminar indicadores.

• ** Análisis visual** — lee los valores de los indicadores, niveles de precio y anotaciones de tu gráfico.

• **Dibujar en gráficos — líneas de tendencia, líneas horizontales, rectángulos, anotaciones de texto.

• Gestionar alertas — crea, lista y elimina alertas de precio.

• Práctica con Replay — avanza por barras históricas paso a paso, practica entradas y salidas.

• Capturas de pantalla — captura el estado del gráfico para su análisis con IA.

• Distribuciones multicelda — configura rejillas de 2x2, 3x1, etc. con símbolos distintos en cada panel.

• Supervisar tu gráfico — emite JSONL desde tu gráfico local para scripts de supervisión locales.

• Acceso CLI — todas las herramientas MCP son también comandos de la CLI tv, aptos para tuberías y con salida JSON.

• Iniciar TradingView — detecta y lanza automáticamente con modo de depuración desde cualquier plataforma.

Instalar con Claude Code

Pega esto en Claude Code y se encargará del resto:

Instala el incentivo servidor MCP de TradingView. Clona https://github.com/tradesdontlie/tradingview-mcp.git, ejecuta npm install, añádelo a tu config MCP en ~/.claude/.mcp.json y lanza TradingView activando el puerto de depuración. Luego verifica la conexión con tv_health_check.

O sigue los pasos manuales siguientes.

Inicio rápido

1. Instalar

git clone https://github.com/tradesdontlie/tradingview-mcp.git
cd tradingview-mcp
npm install

2. Iniciar TradingView con CDP

TradingView Desktop debe estar en ejecución con Chrome DevTools Protocol y el puerto 9222 habilitado.

macOS:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

Desde cualquier plataforma, también manualmente:

/path/to/TradingView --remote-debugging-port=9222

O con la herramienta MCP (detecta automáticamente tu sistema):

Usa tv_launch para iniciar TradingView en modo de depuración.

3. Añadir a Claude Code

Añade esta entrada a tu configuración traslada la configuración MCP de Claude Code (~/.claude/.mcp.json o .mcp.json del proyecto):

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/path/to/tradingview-mcp/src/server.js"]
    }
  }
}

Reemplaza /path/to/tradingview-mcp con tu ruta real.

4. Verificar

Pregunta a Claude: "Usa tv_health_check para saber si TradingView está conectado"

CLI

Toda herramienta MCP también está disponible como un comando de la CLI tv. La salida es JSON para que se pueda pasar a jq.

# Install globally (optional)
npm link

# Or run directly
node src/cli/index.js <command>

Ejemplos rápidos

tv status                          # check connection
tv quote                           # current price
tv symbol AAPL                     # change symbol
tv ohlcv --summary                 # price summary
tv screenshot -r chart             # capture chart
tv pine compile                    # compile Pine Script
tv pane layout 2x2                 # 4-chart grid
tv pane symbol 1 ES1!              # set pane symbol
tv stream quote | jq '.close'      # monitor price changes

Todos los comandos

tv status / launch / state / symbol / timeframe / type / info / search
tv quote / ohlcv / values
tv data lines/labels/tables/boxes/strategy/trades/equity/depth/indicator
tv pine get/set/compile/analyze/check/save/new/open/list/errors/console
tv draw shape/list/get/remove/clear
tv alert list/create/delete
tv watchlist get/add
tv indicator add/remove/toggle/set/get
tv layout list/switch
tv pane list/layout/focus/symbol
tv tab list/new/close/switch
tv replay start/step/stop/status/autoplay/trade
tv stream quote/bars/values/lines/labels/tables/all
tv ui click/keyboard/hover/scroll/find/eval/type/panel/fullscreen/mouse
tv screenshot / discover / ui-state / range / scroll

Streaming

Los comandos tv stream sondean tu instancia de TradingView Desktop en ejecución local a intervalos regulares a través de Chrome DevTools Protocol en localhost.

No se realiza ninguna conexión con los servidores de TradingView. Todos los datos se quedan en tu máquina.

[!WARNING] El consumo programático de los datos de TradingView puede entrar en conflicto con sus Términos de Uso, independientemente de la fuente de los datos. Eres el único responsable de que tu uso cumpla con ellos.

tv stream quote                          # price tick monitoring
tv stream bars                           # bar-by-bar updates
tv stream values                         # indicator value monitoring
tv stream lines --filter "NY Levels"     # price level monitoring
tv stream tables --filter Profiler       # table data monitoring
tv stream all                            # all panes at once (multi-symbol)

Cómo sabe Claude qué herramienta usar

Claude lee el archivo CLAUDE.md automáticamente cuando trabaja en este proyecto. Contiene un árbol de decisión completo:

Referencia de herramientas (78 herramientas MCP)

Lectura de gráficos

Datos de indicadores personalizados (dibujos de Pine)

Lee la salida de line.new(), label.new(), table_new() y box_new() de cualquier indicador Pine visible.

Usa siempre study_filter para apuntar a un indicador concreto: study_filter: "Profiler".

Control de gráficos

Diseños de varios paneles

Gestión de pestañas

Desarrollo de Pine Script

Modo Replay

Dibujos, alertas y automatización de la interfaz de usuario

Gestión de contexto

Las herramientas devuelven una salida compacta por defecto para minimizar el uso de contexto. Para un flujo de trabajo típico de "analizar mi gráfico", el contexto total es de ~5-10KB en lugar de ~80KB.

Cómo encontrar TradingView en tu sistema

Los scripts de lanzamiento y tv_launch detectan TradingView automáticamente. Si la detección automática falla:

El flag clave: --remote-debugging-port=9222

Pruebas

# Requires TradingView running with --remote-debugging-port=9222
npm test

29 pruebas que cubren: análisis estático de Pine Script, compilación en el servidor y enrutamiento CLI.

Arquitectura

Claude Code  ←→  MCP Server (stdio)  ←→  CDP (port 9222)  ←→  TradingView Desktop (Electron)

• Transporte: MCP sobre stdio (84 herramientas) + CLI (comando tv, 30 comandos con 66 subcomandos)

• Conexión: Protocolo Chrome DevTools en localhost:9222

• Streaming: bucle de sondeo y diferencias con deduplicación, salida JSONL a stdout

• Sin dependencias más allá de @modelcontextprotocol/sdk y chrome-remote-interface

Atribuciones

Este proyecto no está afiliado, respaldado ni asociado con:

• TradingView Inc. — TradingView es una marca comercial de TradingView Inc.

• Anthropic — Claude y Claude Code son marcas comerciales de Anthropic, PBC.

Esta herramienta es un servidor MCP independiente que se conecta a Claude Code mediante el protocolo MCP estándar. No contiene ni modifica ningún software de Anthropic.

Descargo de responsabilidad

Este proyecto se proporciona solo con fines personales, educativos y de investigación.

Cómo funciona esta herramienta: Esta herramienta utiliza el Protocolo Chrome DevTools (CDP), la interfaz de depuración estándar integrada en las aplicaciones basadas en Chromium. No realiza ingeniería inversa de ningún protocolo propietario de TradingView, no se conecta a los servidores de TradingView ni elude ningún control de acceso. El puerto de depuración debe ser habilitado explícitamente por el usuario mediante un flag estándar de línea de comandos de Chromium (--remote-debugging-port=9222).

Al usar este software, reconoces y aceptas que:

1. Eres el único responsable de garantizar que tu uso de esta herramienta cumpla con los Términos de uso de TradingView y todas las leyes aplicables.

2. Los Términos de uso de TradingView restringen la recopilación automatizada de datos, el scraping y el uso no visual de su plataforma y sus datos. Esta herramienta utiliza el Protocolo Chrome DevTools para interactuar programáticamente con la aplicación de escritorio de TradingView, lo que puede entrar en conflicto con esos términos.

3. Asumes todo el riesgo asociado con el uso de esta herramienta. Los autores no son responsables de ningún bloqueo de cuenta, suspensión, acción legal u otras consecuencias derivadas de su uso.

4. Esta herramienta no debe utilizarse para, incluyendo pero sin limitarse a:

   • Redistribuir, revender o explotar comercialmente los datos de mercado de TradingView

   • Eludir los controles de acceso o las restricciones de suscripción de TradingView

   • Realizar trading automatizado o toma de decisiones algorítmica utilizando datos extraídos

   • Violar los derechos de propiedad intelectual de los autores de indicadores Pine Script

   • Conectarse a los servidores o la infraestructura de TradingView (todo el acceso se realiza a través de la aplicación de escritorio que se ejecuta localmente)

5. La funcionalidad de streaming supervisa únicamente tu instancia local de TradingView Desktop en ejecución. No se conecta a los servidores de TradingView ni extrae datos de la infraestructura de TradingView.

6. Los datos de mercado a los que se accede a través de esta herramienta siguen sujetos a los términos de licencia de los exchanges y los proveedores de datos. No redistribuyas, almacenes ni explotes comercialmente ningún dato obtenido a través de esta herramienta.

7. Esta herramienta accede a interfaces internas y no documentadas de la aplicación de TradingView que pueden cambiar o dejar de funcionar en cualquier momento sin previo aviso.

Úsala bajo tu propio riesgo. Si no estás seguro de si el uso que pretendes darle cumple con los términos de TradingView, no utilices esta herramienta.

Licencia

MIT — consulta LICENSE para más detalles.

La licencia MIT se aplica únicamente al código fuente de este proyecto. No otorga ningún derecho sobre el software, los datos, las marcas comerciales o la propiedad intelectual de TradingView.