Skip to main content
Glama
rkilchmn

TradingView MCP

by rkilchmn

TradingView MCP

Сервер Model Context Protocol (MCP) для TradingView Desktop на вашем компьютере: чтение графиков, запуск утреннего брифинга, разработка Pine Script и автоматизация рабочих процессов через Chrome DevTools Protocol (localhost:9222).

Поддерживается John Anthony. Этот проект расширяет вышестоящий tradingview-mcp от @tradesdontlie рабочим процессом утреннего брифинга, конфигурацией правил (rules.json) и исправлениями для tv_launch в TradingView Desktop v2.14+.

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

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

[!NOTE] Вся обработка данных происходит локально. Ничего никуда не отправляется. Никакие данные TradingView не покидают ваш компьютер.


Что нового в этом форке

Функция

Что она делает

morning_brief

Одна команда, которая сканирует ваш список наблюдения, считывает все ваши индикаторы и возвращает структурированные данные для генерации Claude вашего торгового уклона на сессию

session_save / session_get

Сохраняет ваш ежедневный брифинг в ~/.tradingview-mcp/sessions/, чтобы вы могли сравнивать сегодня со вчера

rules.json

Запишите свои торговые правила один раз — критерии уклона, правила риска, список наблюдения. Утренний брифинг применяет их автоматически каждый день

Исправление запуска

Исправлена совместимость tv_launch с TradingView Desktop v2.14+

CLI tv brief

Запустите утренний брифинг из терминала одним словом


Related MCP server: TradingView MCP Bridge

Настройка в один шаг

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

Set up TradingView MCP for me. 
Clone https://github.com/anthonyjohn17/tradingview-mcp.git to ~/tradingview-mcp, run npm install, then add it to my MCP config at ~/.claude/.mcp.json (merge with any existing servers, don't overwrite them). 
The config block is: { "mcpServers": { "tradingview": { "command": "node", "args": ["/Users/YOUR_USERNAME/tradingview-mcp/src/server.js"] } } } — replace YOUR_USERNAME with my actual username.
Then copy rules.example.json to rules.json and open it so I can fill in my trading rules.
Finally restart and verify with tv_health_check.

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


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

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

  • Node.js 18+

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

  • macOS, Windows или Linux


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

1. Клонируйте и установите

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

2. Настройте свои правила

cp rules.example.json rules.json

Откройте rules.json и заполните:

  • Ваш список наблюдения (символы для сканирования каждое утро)

  • Ваши критерии уклона (что для вас означает бычий/медвежий/нейтральный)

  • Ваши правила риска (правила, которые Claude должен проверять перед каждой сессией)

3. Запустите TradingView с CDP

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

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

Или используйте инструмент MCP после настройки: «Используй tv_launch, чтобы запустить TradingView в режиме отладки»

4. Добавьте в Claude Code

Добавьте в ~/.claude/.mcp.json (объедините с существующими серверами):

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

Замените YOUR_USERNAME на ваше фактическое имя пользователя. На Mac: echo $USER для проверки.

Транспорт SSE (альтернатива)

Запустите MCP-сервер через HTTP/SSE вместо stdio:

Запуск SSE-сервера:

# Mac/Linux
TRANSPORT=sse PORT=3000 node src/server.js

# Windows
set TRANSPORT=sse
node src/server.js

Скрипты запуска:

# Mac/Linux - custom port
./scripts/launch_mcp_sse.sh 8080

# Windows - custom port
scripts\launch_mcp_sse.bat 8080

Настройка Claude Code для подключения через SSE:

{
  "mcpServers": {
    "tradingview": {
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

SSE-сервер по умолчанию слушает http://127.0.0.1:3000/sse. Переопределите порт переменной окружения PORT.

5. Проверка

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

6. Запустите первый утренний брифинг

Спросите Claude: «Запусти morning_brief и дай мне мой торговый уклон на сессию»

Или из терминала:

npm link  # install tv CLI globally (one time)
tv brief

Рабочий процесс утреннего брифинга

Это функция, которая превращает этот инструментарий в ежедневную привычку.

Перед каждой сессией:

  1. TradingView открыт (запущен с отладочным портом)

  2. Запустите: tv brief в терминале (или попросите Claude: «запусти morning_brief»)

  3. Claude сканирует каждый символ в вашем списке наблюдения, считывает значения ваших индикаторов, применяет критерии из вашего rules.json и выводит:

BTCUSD  | BIAS: Bearish  | KEY LEVEL: 94,200  | WATCH: RSI crossing 50 on 4H
ETHUSD  | BIAS: Neutral  | KEY LEVEL: 3,180   | WATCH: Ribbon direction on daily
SOLUSD  | BIAS: Bullish  | KEY LEVEL: 178.50  | WATCH: Hold above 20 EMA

Overall: Cautious session. BTC leading bearish, SOL the exception — watch for divergence.
  1. Сохраните: «сохрани этот брифинг» (использует session_save)

  2. На следующее утро сравните: «получи вчерашнюю сессию» (использует session_get)


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

  • Утренний брифинг — сканирование списка наблюдения, чтение индикаторов, применение ваших правил, вывод торгового уклона на сессию

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

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

  • Визуальный анализ — чтение значений индикаторов, уровней цен, нарисованных уровней из пользовательских индикаторов

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

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

  • Практика в реплее — пошаговый проход по историческим барам, отработка входов и выходов с отслеживанием P&L

  • Скриншоты — захват состояния графика

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

  • Потоковая передача данных — вывод JSONL с вашего живого графика для скриптов мониторинга

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


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

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

Вы говорите...

Claude использует...

«Запусти мой утренний брифинг»

morning_brief → применить правила → session_save

«Какой у меня был уклон вчера?»

session_get

«Что у меня на графике?»

chart_get_state → data_get_study_values → quote_get

«Дай полный анализ»

quote_get → data_get_study_values → data_get_pine_lines → data_get_pine_labels → capture_screenshot

«Переключи на BTCUSD дневной»

chart_set_symbol → chart_set_timeframe

«Напиши Pine Script для...»

pine_set_source → pine_smart_compile → pine_get_errors

«Запусти реплей с 1 марта»

replay_start → replay_step → replay_trade

«Настрой сетку из 4 графиков»

pane_set_layout → pane_set_symbol

«Нарисуй уровень на 94200»

draw_shape (horizontal_line)


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

Утренний брифинг (новое в этом форке)

Инструмент

Что делает

morning_brief

Сканирование списка наблюдения, чтение индикаторов, возврат структурированных данных для торгового уклона на сессию. Автоматически читает rules.json.

session_save

Сохраняет сгенерированный брифинг в ~/.tradingview-mcp/sessions/YYYY-MM-DD.json

session_get

Получает сегодняшний брифинг (или вчерашний, если сегодняшний ещё не сохранён)

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

Инструмент

Когда использовать

Размер вывода

chart_get_state

Первый вызов — получить символ, таймфрейм, все названия индикаторов и их ID

~500B

data_get_study_values

Чтение текущих значений RSI, MACD, BB, EMA со всех индикаторов

~500B

quote_get

Получить последнюю цену, OHLC, объём

~200B

data_get_ohlcv

Получить ценовые бары. Используйте summary: true для компактной статистики

500B (сводка) / 8KB (100 баров)

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

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

Инструмент

Когда использовать

data_get_pine_lines

Горизонтальные ценовые уровни (поддержка/сопротивление, уровни сессии)

data_get_pine_labels

Текстовые аннотации + цены («PDH 24550», «Bias Long»)

data_get_pine_tables

Таблицы данных (статистика сессии, панели аналитики)

data_get_pine_boxes

Ценовые зоны как пары {high, low}

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

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

Инструмент

Что делает

chart_set_symbol

Смена тикера (BTCUSD, AAPL, ES1!, NYMEX:CL1!)

chart_set_timeframe

Смена разрешения (1, 5, 15, 60, D, W, M)

chart_set_type

Смена стиля (Candles, HeikinAshi, Line, Area, Renko)

chart_manage_indicator

Добавление/удаление индикаторов. Используйте полные названия: «Relative Strength Index», а не «RSI»

chart_scroll_to_date

Переход к дате (ISO: «2025-01-15»)

indicator_set_inputs / indicator_toggle_visibility

Изменение настроек индикатора, показать/скрыть

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

Инструмент

Шаг

pine_set_source

1. Внедрить код в редактор

pine_smart_compile

2. Скомпилировать с автодетекцией + проверкой ошибок

pine_get_errors

3. Прочитать ошибки компиляции, если есть

pine_get_console

4. Прочитать вывод log.info()

pine_save

5. Сохранить в облако TradingView

pine_analyze

Офлайн-статический анализ (график не нужен)

pine_check

Проверка компиляции на сервере (график не нужен)

Режим реплея

Инструмент

Шаг

replay_start

Войти в реплей с даты

replay_step

Продвинуться на один бар

replay_autoplay

Автопрокрутка (задать скорость в мс)

replay_trade

Купить/продать/закрыть позиции

replay_status

Проверить позицию, P&L, дату

replay_stop

Вернуться в реальное время

Многопанельность, оповещения, рисунки, интерфейс

Инструмент

Что делает

pane_set_layout

Изменить сетку: s, 2h, 2v, 2x2, 4, 6, 8

pane_set_symbol

Установить символ на любой панели

draw_shape

Нарисовать горизонтальную_линию, трендовую_линию, прямоугольник, текст

alert_create / alert_delete / alert_list

Управление ценовыми оповещениями

batch_run

Выполнить действие для нескольких символов/таймфреймов

watchlist_get / watchlist_add

Чтение/изменение списка наблюдения

capture_screenshot

Снимок экрана (области: полная, график, тестер_стратегий)

tv_launch / tv_health_check

Запуск TradingView и проверка подключения


Команды CLI

tv brief                           # run morning brief
tv session get                     # get today's saved brief
tv session save --brief "..."      # save a brief

tv status                          # check connection
tv quote                           # current price
tv symbol BTCUSD                   # 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 stream quote | jq '.close'      # monitor price ticks

Полный список команд: tv --help


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

Проблема

Решение

cdp_connected: false

TradingView не запущен с --remote-debugging-port=9222. Используйте скрипт запуска.

ECONNREFUSED

TradingView не запущен или порт 9222 заблокирован

Сервер MCP не отображается в Claude Code

Проверьте синтаксис ~/.claude/.mcp.json, перезапустите Claude Code

Команда tv не найдена

Выполните npm link из каталога проекта

morning_brief — «No rules.json found»

Выполните cp rules.example.json rules.json и заполните его

morning_brief — список наблюдения пуст

Добавьте символы в массив watchlist в rules.json

Инструменты возвращают устаревшие данные

TradingView всё ещё загружается — подождите несколько секунд

Инструменты Pine Editor не работают

Сначала откройте панель Pine Editor: ui_open_panel pine-editor open


Архитектура

Claude Code  ←→  MCP Server (stdio or SSE)  ←→  CDP (port 9222)  ←→  TradingView Desktop (Electron)
  • 78 оригинальных инструментов + 3 инструмента утреннего брифинга = 81 инструмент MCP всего

  • Транспорт: MCP через stdio (по умолчанию) или SSE (TRANSPORT=sse)

  • Подключение: Chrome DevTools Protocol на localhost:9222

  • Без внешних сетевых вызовов — всё работает локально

  • Ноль дополнительных зависимостей сверх оригинальных

Транспорт SSE

Запустите сервер через HTTP/SSE вместо stdio:

TRANSPORT=sse node src/server.js

Сервер прослушивает http://127.0.0.1:3000/sse по умолчанию. Переопределите с помощью:

TRANSPORT=sse PORT=8080 HOST=0.0.0.0 node src/server.js

Настройте Claude Code для подключения через SSE:

{
  "mcpServers": {
    "tradingview": {
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

Благодарности

  • Вышестоящий проект: tradingview-mcp от @tradesdontlie — оригинальный мост и основа MCP.

  • Этот форк: John Anthony — утренний брифинг, вспомогательные функции сессий, rules.json и исправления запуска для последних сборок TradingView Desktop.

Если вы находите вышестоящий проект полезным, поставьте звезду их репозиторию.


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

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

Этот инструмент использует Chrome DevTools Protocol (CDP) — стандартный интерфейс отладки, встроенный во все приложения на базе Chromium. Он не занимается реверс-инжинирингом проприетарного протокола TradingView, не подключается к серверам TradingView и не обходит никакие средства контроля доступа. Порт отладки должен быть явно включён пользователем с помощью стандартного флага командной строки Chromium.

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

  1. Вы несёте единоличную ответственность за то, чтобы ваше использование соответствовало Условиям использования TradingView и всем применимым законам.

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

  3. Этот инструмент не должен использоваться для распространения, перепродажи или коммерческой эксплуатации рыночных данных TradingView.

  4. Авторы не несут ответственности за блокировку аккаунтов, приостановку действия или иные последствия.

Используйте на свой страх и риск.

Лицензия

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

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to interact with TradingView Desktop charts for analysis, Pine Script development, and workflow automation via Chrome DevTools Protocol.
    94 npm
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with locally running TradingView Desktop for chart analysis, Pine Script development, and workflow automation via Chrome DevTools Protocol.
    94 npm
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to interact with locally running TradingView Desktop for chart analysis, Pine Script development, and automation via Chrome DevTools Protocol.
    94 npm
    -