TradingView MCP Bridge

Персональный ИИ-ассистент для ваших графиков TradingView Desktop. Подключает Claude Code к вашему локально запущенному приложению TradingView через Chrome DevTools Protocol для анализа графиков с помощью ИИ, разработки Pine Script и автоматизации рабочих процессов.

[!WARNING] Этот инструмент не связан с TradingView Inc., не одобрен ею и не ассоциирован с ней. Он взаимодействует с вашим локально запущенным приложением TradingView Desktop через Chrome DevTools Protocol. Перед использованием ознакомьтесь с Дисклеймером.

[!IMPORTANT] Требуется действующая подписка TradingView. Этот инструмент не обходит никакие платные ограничения или средства контроля доступа TradingView. Он считывает данные и управляет уже запущенным приложением TradingView Desktop на вашей машине.

[!NOTE] Вся обработка данных происходит локально на вашей машине. Этот инструмент не передаёт, не хранит и не распространяет данные TradingView вовне.

[!CAUTION] Этот инструмент обращается к недокументированным внутренним API TradingView через интерфейс отладки Electron. Они могут измениться или сломаться без предупреждения в любом обновлении TradingView. Зафиксируйте версию TradingView Desktop, если для вас важна стабильность.

Как это работает (и почему это безопасно)

Этот инструмент не подключается к серверам TradingView, не изменяет файлы TradingView и не перехватывает сетевой трафик. Он взаимодействует исключительно с вашим локально запущенным экземпляром TradingView Desktop через Chrome DevTools Protocol (CDP) — стандартным интерфейсом отладки, встроенным во все приложения Chromium/Electron от Google, включая VS Code, Slack и Discord.

Отладочный порт по умолчанию отключён, и вы должны явно включить его с помощью стандартного флага Chromium (--remote-debugging-port=9222). Ничего не происходит без этого намеренного шага.

Related MCP server: TradingView MCP Bridge

Чего этот инструмент не делает

• Не подключается к серверам или API TradingView

• Не хранит, не передаёт и не распространяет какие-либо рыночные данные

• Не работает без действующей подписки TradingView и установленного Desktop-приложения

• Не обходит какие-либо платные ограничения или ограничения доступа TradingView

• Не совершает реальные сделки (только взаимодействие с графиком)

• Не работает, если TradingView изменит свою внутреннюю структуру Electron

Исследовательский контекст

Этот проект исследует открытый исследовательский вопрос: как агенты на основе LLM могут взаимодействовать с профессиональными торговыми интерфейсами для поддержки принятия решений человеком?

В частности, исследуется:

• Как структурированные инструментальные API (MCP) могут соединять LLM и десктопные финансовые приложения с сохранением состояния

• Какие ограничения по задержке, контексту и надёжности возникают, когда агент работает с живыми данными графиков

• Как агенты обрабатывают неоднозначное состояние финансового интерфейса (например, интерпретация вывода Pine Script, чтение таблиц индикаторов)

• Является ли естественный язык эффективным интерфейсом для навигации по графикам и разработки Pine Script

• Каковы сценарии отказов LLM-агентов, работающих в средах с данными в реальном времени

Это не торговый бот. Это интерфейсный слой, который делает торговое приложение понятным для LLM-агента, позволяя исследователям и разработчикам изучать взаимодействие человека и ИИ в финансовых рабочих процессах.

См. RESEARCH.md с открытыми вопросами, результатами и связанными работами.

Предварительные требования

• Приложение TradingView Desktop (требуется платная подписка для данных в реальном времени)

• Node.js 18+

• Claude Code с поддержкой MCP (для MCP-инструментов) или любой терминал (для CLI)

• macOS, Windows или Linux

Что он делает

Даёт вашему ИИ-ассистенту глаза и руки на вашем графике:

• Разработка Pine Script — пишите, внедряйте, компилируйте, отлаживайте и итерируйте скрипты с помощью ИИ

• Навигация по графикам — изменяйте символы, таймфреймы, масштабируйте к датам, добавляйте/удаляйте индикаторы

• Визуальный анализ — читайте значения индикаторов, ценовые уровни и аннотации на вашем графике

• Рисование на графиках — трендовые линии, горизонтальные линии, прямоугольники, текстовые аннотации

• Управление оповещениями — создавайте, просматривайте и удаляйте ценовые оповещения

• Практика Replay — проходите по историческим барам, отрабатывайте входы/выходы

• Скриншоты — захватывайте состояние графика для визуального анализа ИИ

• Многопанельные макеты — настраивайте сетки 2x2, 3x1 и т.д. с разными символами на каждой панели

• Мониторинг графика — транслируйте JSONL с вашего локального графика для локальных скриптов мониторинга

• CLI-доступ — каждый MCP-инструмент также является командой CLI tv, удобной для конвейеров с JSON-выводом

• Запуск TradingView — автоматическое определение и запуск в режиме отладки на любой платформе

Установка с помощью Claude Code

Вставьте это в Claude Code, и он сделает всё остальное:

Установите MCP-сервер TradingView. Клонируйте https://github.com/tradesdontlie/tradingview-mcp.git, выполните npm install, добавьте его в мой MCP-конфиг в ~/.claude/.mcp.json и запустите TradingView с отладочным портом. Затем проверьте подключение с помощью tv_health_check.

Или следуйте ручным шагам ниже.

Быстрый старт

1. Установка

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

2. Запуск TradingView с CDP

TradingView Desktop должен быть запущен с включённым Chrome DevTools Protocol на порту 9222.

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

Или запустите вручную на любой платформе:

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

Или используйте MCP-инструмент (автоматически определяет вашу установку):

«Используйте tv_launch для запуска TradingView в режиме отладки»

3. Добавление в Claude Code

Добавьте в ваш MCP-конфиг Claude Code (~/.claude/.mcp.json или проектный .mcp.json):

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

Замените /path/to/tradingview-mcp на ваш фактический путь.

4. Проверка

Спросите Claude: «Используйте tv_health_check, чтобы проверить, что TradingView подключён»

CLI

Каждый MCP-инструмент также доступен как команда CLI tv. Все выходные данные — JSON для передачи через jq.

# Install globally (optional)
npm link

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

Быстрые примеры

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

Все команды

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

Потоковая передача

Команды tv stream с регулярными интервалами опрашивают ваш локально запущенный экземпляр TradingView Desktop через Chrome DevTools Protocol на localhost.

Никакого подключения к серверам TradingView не выполняется. Все данные остаются на вашей машине.

[!WARNING] Программное потребление данных TradingView может противоречить их Условиям использования независимо от источника данных. Вы несёте единоличную ответственность за то, чтобы ваше использование соответствовало требованиям.

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)

Как Claude понимает, какой инструмент использовать

Claude автоматически читает CLAUDE.md при работе в этом проекте. В нём содержится полное дерево решений:

Справочник инструментов (78 MCP-инструментов)

Чтение графиков

Данные пользовательских индикаторов (Pine Drawings)

Читайте вывод line.new(), label.new(), table.new(), box.new() любого видимого Pine-индикатора.

Всегда используйте study_filter, чтобы нацелиться на конкретный индикатор: study_filter: "Profiler".

Управление графиком

Многопанельные макеты

Управление вкладками

Разработка Pine Script

Режим воспроизведения

Графические объекты, оповещения и автоматизация интерфейса

Управление контекстом

По умолчанию инструменты возвращают компактный вывод, чтобы сократить использование контекста. Для типичного сценария «проанализируй мой график» общий объём контекста составляет примерно 5–10 KБ вместо ~80 KБ.

Как найти TradingView на вашем компьютере

Скрипты запуска и директива tv_launch автоматически определяют TradingView. Если автодетект не сработал — используйте таблицу ниже:

Ключевой флаг: --remote-debugging-port=9222.

Тестирование

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

29 тестов, покрывающих: статический анализ Pine Script, серверную компиляцию и маршрутизацию CLI.

Архитектура

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

• Транспорт: MCP через stdio (84 инструмента) + CLI (tv команда, 30 команд с 66 подкомандами)

• Соединение: Chrome DevTools Protocol на localhost:9222

• Потоковый polling/хранение с дедупликацией, вывод JSONL в stdout

• Без внешних зависимостей кроме @modelcontextprotocol/sdk и chrome-remote-interface

Атрибуция

Этот проект не является родственным, одобренным или связанным с:

• TradingView Inc. — TradingView является товарным знаком TradingView Inc.

• Anthropic — Claude и Claude Code являются товарными знаками Anthropic, PBC.

Этот инструмент — независимый MCP-сервер, который подключается к Claude Code через стандартный протокол MCP. Он не содержит и не модифицирует программное обеспечение Anthropic.

Отказ от ответственности

Этот проект предоставляется исключительно для личных, образовательных и исследовательских целей.

Как работает этот инструмент: Инструмент использует Chrome DevTools Protocol (cdp — интерфейс отладки Chromium). Не делает реверс-инжиниринг собственного протокола TradingView, не подключается к серверам TradingView и не обходит контроль доступа. Отладочный порт должен быть явно включен пользователем через стандартный флаг Chromium (--remote-debugging-port=9222).

Используя это программное обеспечение, вы признаёте и соглашаетесь с тем, что:

1. Вы несёте единоличную ответственность за соответствие вашего использования этого инструмента условиям TradingView's Terms of Use и применяемому законодательству.

2. Условия использования tradingview запрещают автоматизированный сбор данных, парсинг и использование не в целях отображения их платформы и данных. Этот инструмент использует Chrome DevTools Protocol для программного взаимодействия с desktop-приложением TradingView, что может конфликтовать с этими условиями.

3. Вы принимаете все риски, связанные с использованием этого инструмента. Авторы не несут ответственности за блокировки аккаунтов, приостановки, судебные иски или другие последствия, возникшие в результате его использования.

4. Данный инструмент не должен быть использован в следующих целях, включая, но не ограничиваясь:

   • Перепродажа, редистрибуция или коммерческое использование маркетинговых данных TradingView

   • Обход лимитов доступа или ограничений подписки TradingView

   • Автоматическая торговля или алгоритмическое решение с использованием извлечённых данных

   • Нарушение авторских прав разработчиков индикаторов Pine Script

   • Подключение к серверам или инфраструктуре TradingView (весь доступ только через локальный desktop-апп)

5. Функция потоковой передачи следит только за вашим локально работающим приложением TradingView Desktop. Он не подключается к серверам TradingView и не извлекает данные из инфраструктуры TradingView.

6. Данные используемые этим инструментом могут быть ограничены условиями лицензии торговых бирж и поставщиков данных. Не распространяйте, не храните и не эксплуатируйте данные, полученные через этот инструмент.

7. Этот инструмент обращается к внутренним недокументированным интерфейсам, которые могут измениться или быть сломаны в любой момент без уведомления.

Используйте на свой риск. Если вы не уверены, соответствует ли ваше планируемое использование условиям TradingView, не используйте этот инструмент.

Лицензия

MIT — см. LICENSE.

Лицензия MIT применяется только к исходному коду данного проекта. Она не предоставляет прав на программное обеспечение, данные, торговые марки или интеллектуальную собственность TradingView.