tradingview-mcp

tradingview-mcp/  v0.1   ──────────────────────────────────────────────────

Un servidor MCP enfocado y con tipado fuerte que permite a Claude Code (o cualquier cliente compatible con MCP) controlar una aplicación de TradingView Desktop en ejecución local: leer el estado del gráfico, cambiar símbolos y marcos temporales, obtener barras OHLCV y capturar capturas de pantalla.

Lo que hace

Envuelve el gráfico de TradingView Desktop en un pequeño conjunto de herramientas MCP bien definidas. Las herramientas están tipadas de extremo a extremo con esquemas de Zod, validadas en el límite y muestran mensajes de error útiles cuando algo sale mal.

                  ┌───────────────┐
                  │ Claude Code   │
                  │ (or any MCP   │
                  │  client)      │
                  └───────┬───────┘
                          │ stdio (MCP)
                          ▼
                  ┌───────────────┐
                  │tradingview-mcp│
                  └───────┬───────┘
                          │ Chrome DevTools Protocol
                          ▼
                  ┌───────────────┐
                  │ TradingView   │
                  │ Desktop       │
                  │ (--remote-    │
                  │  debugging-   │
                  │  port=9222)   │
                  └───────────────┘

¿Por qué otra integración de TradingView?

Existen proyectos de automatización de TradingView. Este está deliberadamente limitado:

• 12 herramientas, no 78. Cada herramienta está documentada, tipada y probada.

• TypeScript estricto. Sin any, sin retornos implícitos, noUncheckedIndexedAccess activado.

• Una responsabilidad por archivo. La conexión, la página, las herramientas y el servidor son capas separadas: la deriva de versiones solo requiere arreglar un punto.

• Errores tipados. ConnectionError, ToolExecutionError, ChartStateError, etc., con mensajes procesables.

• tradingview-mcp doctor. Un comando de diagnóstico que le dice exactamente qué está mal en su configuración.

Use esto si desea una superficie pequeña y predecible que pueda leer en una tarde. Use las alternativas "todo incluido" si desea que cada función de TradingView esté envuelta.

Instalación

Requiere Node.js 20+.

npm install -g tradingview-mcp
# or, in a project:
npm install tradingview-mcp

Para desarrollo:

git clone https://github.com/harshil1502/tradingview-mcp.git
cd tradingview-mcp
npm install
npm run build

Configuración: tres pasos

1. Cierre cualquier TradingView Desktop en ejecución

De lo contrario, el puerto de depuración no se puede habilitar.

2. Inicie TradingView Desktop con el puerto de depuración habilitado

macOS:

open -a "TradingView" --args --remote-debugging-port=9222

Windows:

& "C:\Users\<you>\AppData\Local\Programs\TradingView\TradingView.exe" --remote-debugging-port=9222

Linux:

tradingview --remote-debugging-port=9222

3. Verifique la conexión

tradingview-mcp doctor

Si todo está conectado, verá algo como:

tradingview-mcp · doctor
─────────────────────────────────────────────
[ok]  CDP endpoint reachable on localhost:9222
[ok]  TradingView page found (NASDAQ:AAPL · 1h)
[ok]  tvWidget detected — chart state readable
─────────────────────────────────────────────
ready.

Uso con Claude Code

Añada esto a su configuración de MCP de Claude Code (~/.claude/mcp.json o .mcp.json del proyecto):

{
  "mcpServers": {
    "tradingview": {
      "command": "tradingview-mcp",
      "env": {
        "TV_MCP_PORT": "9222"
      }
    }
  }
}

Reinicie Claude Code. Las herramientas a continuación estarán disponibles.

Herramientas

Próximamente más herramientas: consulte docs/roadmap.md.

Sesión de ejemplo

You:    What's the chart showing?
Claude: [calls chart_get_state]
        Showing NASDAQ:AAPL on 1h timeframe with EMA20, EMA50.
        Last price 187.42.

You:    Switch to BTCUSDT 4h and pull the last 200 bars.
Claude: [calls chart_set_symbol, chart_set_timeframe, chart_get_ohlcv]
        Done. Range: 187 days. Open at start: 62,440.
        Close at end: 67,830. +8.6%.

Configuración

Desarrollo

npm install
npm run build         # tsc to dist/
npm run dev           # tsc --watch
npm test              # vitest run
npm run test:coverage # with v8 coverage report
npm run typecheck     # tsc --noEmit

La base de código tiene cuatro capas:

src/
├── index.ts              entry — reads env, starts stdio server
├── server.ts             MCP server, tool registration, request handlers
├── errors.ts             typed error classes
├── types.ts              shared types + Zod schemas
├── connection/
│   ├── cdp.ts            CDP client wrapper (chrome-remote-interface)
│   └── tradingview.ts    TradingView-page interactions (all evaluated JS lives here)
└── tools/
    ├── index.ts          tool registry
    └── chart.ts          chart_* tools

Para añadir una herramienta:

1. Cree un nuevo archivo en src/tools/ (o extienda uno existente).

2. Exporte los esquemas de Zod <name>Input y <name>Output además de la función manejadora.

3. Añada la entrada a TOOLS en src/tools/index.ts.

4. Añada una prueba en tests/.

Eso es todo: autorregistrado, autovalidado, autointrospectivo.

Compatibilidad de versiones

Si TradingView se actualiza y las herramientas comienzan a fallar, revise primero connection/tradingview.ts: ese es el único archivo que conoce la API interna de TradingView.

Descargo de responsabilidad

Este software se proporciona "tal cual" sin garantía de ningún tipo. Al ejecutarlo, usted reconoce:

• Está utilizando su propia instancia de TradingView Desktop pagada, contra sus propios datos.

• Usted mismo habilitó el puerto de depuración de Chrome DevTools.

• La API interna de TradingView no está documentada y puede romperse.

• Nada en este software garantiza la corrección de las decisiones comerciales tomadas por un agente de IA sobre él. Úselo en una cuenta de papel antes de dejar que toque capital real.

Licencia

MIT © 2026 Harshil Patel

Agradecimientos

Esta es una implementación nueva, construida desde cero con el objetivo de ser pequeña, bien tipada y fácil de leer. Si ha trabajado en herramientas similares en este espacio, gracias por abrir el camino.