tradingview-mcp

tradingview-mcp/  v0.1   ──────────────────────────────────────────────────

Компактный, типобезопасный MCP-сервер, который позволяет Claude Code (или любому другому MCP-совместимому клиенту) управлять локально запущенным приложением TradingView Desktop — читать состояние графика, менять символы и таймфреймы, получать бары OHLCV, делать скриншоты.

Что он делает

Оборачивает график TradingView Desktop в небольшой набор четко определенных инструментов MCP. Инструменты типизированы от начала до конца с помощью схем Zod, проверяются на границах и выводят полезные сообщения об ошибках в случае сбоев.

                  ┌───────────────┐
                  │ Claude Code   │
                  │ (or any MCP   │
                  │  client)      │
                  └───────┬───────┘
                          │ stdio (MCP)
                          ▼
                  ┌───────────────┐
                  │tradingview-mcp│
                  └───────┬───────┘
                          │ Chrome DevTools Protocol
                          ▼
                  ┌───────────────┐
                  │ TradingView   │
                  │ Desktop       │
                  │ (--remote-    │
                  │  debugging-   │
                  │  port=9222)   │
                  └───────────────┘

Почему еще одна интеграция с TradingView?

Существуют другие проекты для автоматизации TradingView. Этот намеренно ограничен в функциональности:

• 12 инструментов, а не 78. Каждый инструмент задокументирован, типизирован и протестирован.

• Строгий TypeScript. Никаких any, никаких неявных возвратов, включен noUncheckedIndexedAccess.

• Одна ответственность на файл. Соединение, страница, инструменты и сервер — это отдельные уровни; при изменении версий нужно исправлять только одно место.

• Типизированные ошибки. ConnectionError, ToolExecutionError, ChartStateError и т.д. с понятными сообщениями.

• tradingview-mcp doctor. Диагностическая команда, которая точно скажет, что не так с вашей настройкой.

Используйте это, если вам нужна небольшая, предсказуемая поверхность, которую можно изучить за один вечер. Используйте альтернативы «все включено», если вам нужно обернуть каждую функцию TradingView.

Установка

Требуется Node.js 20+.

npm install -g tradingview-mcp
# or, in a project:
npm install tradingview-mcp

Для разработки:

git clone https://github.com/harshil1502/tradingview-mcp.git
cd tradingview-mcp
npm install
npm run build

Настройка — три шага

1. Закройте все запущенные экземпляры TradingView Desktop

Иначе порт отладки не сможет быть включен.

2. Запустите TradingView Desktop с включенным портом отладки

macOS:

open -a "TradingView" --args --remote-debugging-port=9222

Windows:

& "C:\Users\<you>\AppData\Local\Programs\TradingView\TradingView.exe" --remote-debugging-port=9222

Linux:

tradingview --remote-debugging-port=9222

3. Проверьте соединение

tradingview-mcp doctor

Если все настроено правильно, вы увидите что-то вроде:

tradingview-mcp · doctor
─────────────────────────────────────────────
[ok]  CDP endpoint reachable on localhost:9222
[ok]  TradingView page found (NASDAQ:AAPL · 1h)
[ok]  tvWidget detected — chart state readable
─────────────────────────────────────────────
ready.

Использование с Claude Code

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

{
  "mcpServers": {
    "tradingview": {
      "command": "tradingview-mcp",
      "env": {
        "TV_MCP_PORT": "9222"
      }
    }
  }
}

Перезапустите Claude Code. Инструменты ниже станут доступны.

Инструменты

Скоро появятся новые инструменты — см. docs/roadmap.md.

Пример сессии

You:    What's the chart showing?
Claude: [calls chart_get_state]
        Showing NASDAQ:AAPL on 1h timeframe with EMA20, EMA50.
        Last price 187.42.

You:    Switch to BTCUSDT 4h and pull the last 200 bars.
Claude: [calls chart_set_symbol, chart_set_timeframe, chart_get_ohlcv]
        Done. Range: 187 days. Open at start: 62,440.
        Close at end: 67,830. +8.6%.

Конфигурация

Разработка

npm install
npm run build         # tsc to dist/
npm run dev           # tsc --watch
npm test              # vitest run
npm run test:coverage # with v8 coverage report
npm run typecheck     # tsc --noEmit

Кодовая база состоит из четырех уровней:

src/
├── index.ts              entry — reads env, starts stdio server
├── server.ts             MCP server, tool registration, request handlers
├── errors.ts             typed error classes
├── types.ts              shared types + Zod schemas
├── connection/
│   ├── cdp.ts            CDP client wrapper (chrome-remote-interface)
│   └── tradingview.ts    TradingView-page interactions (all evaluated JS lives here)
└── tools/
    ├── index.ts          tool registry
    └── chart.ts          chart_* tools

Чтобы добавить инструмент:

1. Создайте новый файл в src/tools/ (или расширьте существующий).

2. Экспортируйте схемы Zod <name>Input и <name>Output плюс функцию-обработчик.

3. Добавьте запись в TOOLS в src/tools/index.ts.

4. Добавьте тест в tests/.

Это все — авторегистрация, автопроверка, автоинтроспекция.

Совместимость версий

Если TradingView обновится и инструменты перестанут работать, сначала проверьте connection/tradingview.ts — это единственный файл, который знает о внутреннем API TradingView.

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

Это программное обеспечение предоставляется «как есть», без каких-либо гарантий. Запуская его, вы подтверждаете:

• Вы используете свой собственный платный экземпляр TradingView Desktop для работы со своими данными.

• Вы самостоятельно включили порт отладки Chrome DevTools.

• Внутренний API TradingView не задокументирован и может измениться.

• Ничто в этом программном обеспечении не гарантирует правильность торговых решений, принимаемых ИИ-агентом на его основе. Используйте его на демо-счете, прежде чем позволить ему касаться реального капитала.

Лицензия

MIT © 2026 Harshil Patel

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

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