tradingview-mcp-chefy

MCP de TradingView eficiente en tokens para traders que realmente hacen backtesting.

Este es un fork creado específicamente para probar estrategias. Los MCP de TradingView existentes funcionan bien para la lectura de gráficos y flujos de trabajo matutinos, pero consumen muchos tokens cuando iteras sobre estrategias Pine: cada lectura de backtest vuelca la lista completa de operaciones, la curva de capital y la salida de la consola en tu contexto. Este fork reescribe esas lecturas para agregar datos dentro del tiempo de ejecución de TradingView antes de que los datos crucen la red, devolviendo resúmenes por defecto y detalles bajo demanda.

Créditos

Este proyecto se basa en dos trabajos previos:

• tradesdontlie/tradingview-mcp — el puente CDP original y la superficie de herramientas. El arduo trabajo de scraping es suyo.

• LewisWJackson/tradingview-mcp-jackson — fork que añadió el flujo de trabajo de resumen matutino, configuración de reglas y una corrección de lanzamiento para v2.14+. Este fork es una bifurcación del suyo.

Si esos repositorios te ayudan, dales una estrella.

Qué es diferente en este fork

Efecto neto: una lectura típica de backtest pasa de ~50KB a ~200 bytes. En una sesión de iteración intensa (más de 20 ejecuciones), esta es la diferencia entre gastar $20 en tokens y gastar $1.

Estado

Pre-lanzamiento. El fork está configurado. Las nuevas herramientas de agregación se están escribiendo ahora. Hasta que se lance la v0.2, este repositorio se comporta de forma idéntica a LewisWJackson/tradingview-mcp-jackson; usa ese si necesitas estabilidad hoy.

Hoja de ruta:

• [x] Fork del repositorio, configuración de la estructura

• [ ] backtest_summary con agregación en el navegador

• [ ] backtest_trades_paged paginación con cursor

• [ ] backtest_equity_summary submuestreo

• [ ] pine_console_errors herramienta filtrada

• [ ] Benchmark de costo de tokens vs original

• [ ] PR de correcciones no controvertidas de vuelta al original de LewisWJackson

• [ ] Lanzamiento v0.2

Inicio rápido

Misma configuración que el original por ahora. Cuando las nuevas herramientas lleguen en la v0.2, la ruta de instalación seguirá siendo idéntica; solo podría cambiar el nombre de configuración de mcpServers.

Requisitos previos

• Aplicación de escritorio de TradingView (se requiere suscripción paga para datos en tiempo real / estrategia)

• Node.js 18+

• Claude Code (o cualquier cliente MCP)

• macOS, Windows o Linux

Instalación

git clone https://github.com/Chefy3x/tradingview-mcp-chefy.git ~/tradingview-mcp-chefy
cd ~/tradingview-mcp-chefy
npm install

Iniciar TradingView con puerto de depuración

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

Añadir a Claude Code

Añadir a ~/.claude/.mcp.json (fusionar con los servidores existentes):

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/tradingview-mcp-chefy/src/server.js"]
    }
  }
}

Reemplaza YOUR_USERNAME con tu nombre de usuario real (echo $USER en Mac/Linux).

Verificar

Reinicia Claude Code y pregunta: "Use tv_health_check to verify TradingView is connected."

Arquitectura

Claude Code  ←→  MCP stdio  ←→  src/server.js  ←→  CDP :9222  ←→  TradingView Desktop (Electron)

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

• Agregación: para lecturas de backtest, la expresión JS enviada a través de CDP realiza la reducción dentro del tiempo de ejecución de TradingView antes de devolverla. Mismo salto de red, ~200 veces menos datos cruzando el límite.

• Sin llamadas de red externas — todo se ejecuta localmente

• Cero dependencias añadidas más allá de las que usa el original

Contribución

Camino de doble sentido con el original:

• Mejoras en la eficiencia de tokens para herramientas existentes → Enviaré PRs de vuelta al original de LewisWJackson para que todos se beneficien

• Nueva familia de herramientas backtest_* → se queda en este fork (cambia el modelo mental de cómo se usa el MCP)

Si encuentras un error en rutas de código compartidas, abre un issue aquí y lo redirigiré.

Descargo de responsabilidad

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

Esta herramienta utiliza el protocolo Chrome DevTools (CDP), una interfaz de depuración estándar integrada en todas 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 omite ningún control de acceso. El puerto de depuración debe ser habilitado explícitamente por el usuario a través de una bandera de línea de comandos estándar de Chromium.

Al usar este software, aceptas que:

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

2. Esta herramienta accede a APIs internas no documentadas de TradingView que pueden cambiar en cualquier momento.

3. Esta herramienta no debe utilizarse para redistribuir, revender o explotar comercialmente los datos de mercado de TradingView.

4. Los autores no son responsables de ninguna prohibición de cuenta, suspensión u otras consecuencias.

Úsalo bajo tu propio riesgo.

Licencia

MIT — ver LICENSE. Heredado del original. Se aplica solo al código fuente, no al software, datos o marcas comerciales de TradingView.