tradingview-mcp

MCP-сервер, предоставляющий AI-агентам торговый инструментарий, ориентированный на TradingView: запросы к скринеру, исторические данные по FX и — по мере завершения вех — сканирование паттернов SMC/ICT, отрисовка графиков с разметкой, бэктестинг, инструментарий Pine и набор сопутствующих Agent Skills.

Не аффилирован с TradingView, Inc. «TradingView», «Pine Script» и «Lightweight Charts» — товарные знаки TradingView, Inc.

Статус

M0-M5 завершены: сервер запускается с настройками по умолчанию public/data; опциональные наборы инструментов для сканирования SMC, отрисовки графиков, бэктестинга, синхронизации журнала FX Replay, данных аккаунта TradingView (session), компиляции Pine, Desktop CDP (скриншоты, навигация, рисование на живом графике, чтение собственных индикаторов пользователя — значения plot и зоны FVG/OB, нарисованные в Pine) и декларативных стратегий. В комплекте идёт CLI tv (каждый инструмент = подкоманда, выдающая JSON), 10 сопутствующих навыков и проверенный манифест плагина Claude Code. Открытые вопросы: шлюз доверия M1 всё ещё ожидает от владельца реальных сетапов SMC, размеченных вручную; приёмник вебхуков, MCP Apps и запасной механизм для Python-стратегий в песочнице отложены. Дорожная карта: docs/PLAN.md.

Related MCP server: TradingView MCP Bridge

Установка в качестве плагина Claude Code

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

Установка запрашивает необязательные учётные данные (ключ OANDA для практического счёта, sessionid TradingView) и настройки оператора (TV_TOOLSETS, TV_READ_ONLY, ...) — для набора по умолчанию public,data ничего не требуется, он работает вообще без аккаунта TradingView. Требуется uv в PATH.

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

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

Опциональный набор chart отрисовывает графики через headless Chromium; если вы его включаете, один раз выполните uv run playwright install chromium. Опциональные наборы включаются через TV_TOOLSETS=default,scan,chart,backtest,journal.

Claude Code: .mcp.json из репозитория автоматически регистрирует сервер, когда вы доверяете проекту.

Конфигурация (переменные окружения)

Выполните uv run tv tv_setup_doctor, чтобы проверить все предусловия, — каждая непройденная проверка возвращает точную команду исправления.

Условия использования TradingView

Наборы по умолчанию не используют аккаунт TradingView: набор public обращается к публичному эндпоинту скринера TradingView, а рыночные данные поступают от Dukascopy/OANDA. ToS TradingView запрещает автоматический сбор данных и использование данных не для отображения; опциональные наборы session и desktop (выключены по умолчанию) взаимодействуют с вашим собственным аккаунтом/десктоп-приложением TradingView на ваш собственный риск — их включение — это ваш осознанный выбор, и оно может нарушать ToS TradingView и грозить ограничениями аккаунта. Оба при первом использовании выводят предупреждение о ToS/бане в stderr. Этот проект предназначен для личных исследований/обучения.

Лицензия

MIT — см. LICENSE. Не аффилирован с TradingView, Inc.; защищённые/доступные только по приглашению Pine-скрипты остаются собственностью их авторов — инструменты анализа читают только отрисованный вывод индикаторов на вашем собственном графике, но никогда не их исходный код.