tradingview-mcp

Servidor MCP que brinda a los agentes de IA un kit de herramientas de trading centrado en TradingView: consultas de screener, datos históricos de FX y — a medida que se alcanzan los hitos — escaneo de patrones SMC/ICT, renderizado de gráficos con marcado, backtesting, herramientas Pine y un conjunto de habilidades de agente complementarias.

No afiliado con TradingView, Inc. "TradingView", "Pine Script" y "Lightweight Charts" son marcas comerciales de TradingView, Inc.

Estado

M0-M5 completos: el servidor arranca con los valores predeterminados public/data; conjuntos de herramientas opcionales para escaneo SMC, renderizado de gráficos, backtesting, sincronización de diario FX Replay, datos de cuenta de TradingView (session), compilación Pine, CDP de escritorio (capturas de pantalla, navegación, dibujo en el gráfico en vivo, lectura de los propios indicadores del usuario — valores de trazado y zonas FVG/OB dibujadas con Pine), y estrategias declarativas. Incluye una CLI tv (cada herramienta = un subcomando que emite JSON), 10 habilidades complementarias y un manifiesto de plugin de Claude Code validado. Elementos pendientes: la puerta de confianza de M1 aún espera las configuraciones SMC reales etiquetadas a mano del propietario; el receptor de webhooks, las aplicaciones MCP y la vía de escape de estrategia Python en sandbox están diferidos. Hoja de ruta: docs/PLAN.md.

Related MCP server: TradingView MCP Bridge

Instalar como plugin de Claude Code

/plugin marketplace add Miha21222/tradingview-mcp
/plugin install tradingview-mcp@tradingview-mcp-marketplace

La instalación solicita credenciales opcionales (clave de práctica de OANDA, sessionid de TradingView) y configuraciones del operador (TV_TOOLSETS, TV_READ_ONLY, ...) — no se requiere nada para la superficie predeterminada public,data, que funciona sin ninguna cuenta de TradingView. Requiere uv en PATH.

Inicio rápido

uv sync
uv run python -m tvmcp --check    # list registered tools
uv run python -m tvmcp            # run on stdio
uv run tv --check                 # CLI: list tools
uv run tv tv_data_get_bars '{"symbol":"EURUSD","count":10}'   # CLI: call any tool -> JSON

El conjunto de herramientas opcional chart renderiza mediante Chromium sin interfaz; ejecuta uv run playwright install chromium una vez si lo habilitas. Habilita los conjuntos de herramientas opcionales mediante TV_TOOLSETS=default,scan,chart,backtest,journal.

Claude Code: el .mcp.json del repositorio registra el servidor automáticamente cuando confías en el proyecto.

Configuración (variables de entorno)

Ejecuta uv run tv tv_setup_doctor para verificar cada requisito previo: cada comprobación fallida devuelve el comando de corrección exacto.

Términos de servicio de TradingView

Los conjuntos de herramientas predeterminados no usan ninguna cuenta de TradingView: el conjunto public se comunica con el endpoint público de escáner de TradingView, y los datos de mercado provienen de Dukascopy/OANDA. Los ToS de TradingView prohíben la recopilación automatizada de datos y el uso no visual de sus datos; los conjuntos de herramientas opcionales session y desktop (desactivados por defecto) interactúan con tu propia cuenta/aplicación de escritorio de TradingView bajo tu propio riesgo — habilitarlos es tu elección explícita y puede violar los ToS de TradingView y arriesgar restricciones de cuenta. Ambos imprimen una advertencia de ToS/prohibición en stderr en el primer uso. Este proyecto es para investigación/educación personal.

Licencia

MIT — ver LICENSE. No afiliado con TradingView, Inc.; los scripts Pine protegidos/solo por invitación siguen siendo propiedad de sus autores — las herramientas de estudio leen solo la salida renderizada de los indicadores en tu propio gráfico, nunca su código fuente.