MCP TradingView Server

MCP-сервер (Model Context Protocol) на Python, который предоставляет данные рынка TradingView MCP-клиенту — Claude Desktop, claude.ai или любому другому совместимому клиенту. Данные получаются через tvdatafeed (OHLCV) и tradingview-ta (скринер).

Предоставляемые инструменты

tv_get_indicators подробнее

Рассчитываемые индикаторы: RSI, MACD, Bollinger Bands (с обнаружением сжатия), EMA, SMA, ATR (с уровнями стопов для длинных и коротких позиций), Стохастик, ADX (+DI/−DI), OBV, средний объём и коэффициент объёма за 20 периодов, а также обнаружение расхождений RSI.

Три опции, отключённые по умолчанию:

Допустимые интервалы: 1, 3, 5, 15, 30, 45 (минут), 1H, 2H, 3H, 4H, 1D, 1W, 1M.

Охват скринера

tvdatafeed не предоставляет API скринера. Поэтому tv_screener перебирает жёстко заданный предопределённый набор в MARKET_SYMBOLS (src/mcp_tradingview/client.py) и вычисляет индикаторы по каждому символу через tradingview-ta:

Перечисление ScreenerMarket также принимает futures, india, brazil, australia, canada, europe и hongkong, но ни для одного из этих рынков не задан набор инструментов: вызов возвращает пустой список. Чтобы активировать их, достаточно добавить запись в MARKET_SYMBOLS.

Related MCP server: tradingview-mcp

Архитектура

Client MCP (Claude Desktop, claude.ai…)
    │
    ├── stdio ──► process local
    └── SSE   ──► serveur HTTP (Starlette + uvicorn)
              │
              ├──► tvdatafeed    : bougies OHLCV
              └──► tradingview-ta : screener
                        │
                        └──► cache TTL en mémoire

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

• Python ≥ 3.11

• Учётная запись TradingView необязательна — анонимный доступ работает, но с более строгими лимитами частоты запросов.

• SDK MCP закреплён на версии < 2.0.0: версия 2.x удаляет декораторы @server.list_tools() / @server.call_tool() и переименовывает Tool.inputSchema в Tool.input_schema. Прежде чем поднять это ограничение, необходима миграция.

Установка

git clone https://github.com/mathieubernardi/tradingview_mcp.git
cd tradingview_mcp

pip install -e ".[dev]"

cp .env.example .env   # puis éditer .env

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

Все переменные имеют префикс TV_ и могут передаваться либо через файл .env, либо через окружение.

Двойной префикс в TV_TV_USERNAME / TV_TV_PASSWORD сделан намеренно: префикс окружения TV_ добавляется к полям tv_username / tv_password.

Запуск сервера

Две эквивалентные точки входа: консольный скрипт mcp-tradingview и модуль python -m mcp_tradingview. Второй не зависит от PATH, что делает его более надёжным в Windows.

# Linux / macOS — stdio
TV_TRANSPORT=stdio python -m mcp_tradingview

# Linux / macOS — SSE
TV_TRANSPORT=sse python -m mcp_tradingview

# Windows PowerShell — stdio
$env:TV_TRANSPORT = "stdio"; python -m mcp_tradingview

# Windows PowerShell — SSE
$env:TV_TRANSPORT = "sse"; python -m mcp_tradingview

Интеграция с Claude Desktop (stdio)

Добавьте в claude_desktop_config.json — ~/Library/Application Support/Claude/ в macOS, %APPDATA%\Claude\ в Windows:

{
  "mcpServers": {
    "tradingview": {
      "command": "python",
      "args": ["-m", "mcp_tradingview"],
      "env": {
        "TV_TRANSPORT": "stdio",
        "TV_CACHE_TTL_SECONDS": "60"
      }
    }
  }
}

Если окружение Python не является окружением по умолчанию, замените "python" на абсолютный путь к интерпретатору virtualenv. Чтобы использовать учётную запись TradingView, добавьте TV_TV_USERNAME и TV_TV_PASSWORD в блок env.

В режиме stdio сессия TradingView устанавливается лениво при первом вызове инструмента: рукопожатие MCP отвечает немедленно, и клиент не сталкивается с тайм-аутом при запуске.

Интеграция SSE

TV_TRANSPORT=sse TV_PORT=8765 python -m mcp_tradingview

Разработка

pytest tests/ -v          # tests
ruff check src/ tests/    # lint
mypy src/                 # type checking (strict)

Известные ограничения

• tvdatafeed — неофициальный клиент, который полагается на веб-эндпоинты TradingView: он может перестать работать без предупреждения.

• tv_screener не сканирует весь рынок, а только предопределённый набор инструментов, описанный выше.

• Без премиум-аккаунта TradingView данные могут задерживаться на несколько минут.

• Анонимный доступ имеет значительно более строгие лимиты частоты запросов, чем авторизованная учётная запись.

• Ошибки инструмента возвращаются клиенту в виде JSON {"error": ..., "tool": ..., "arguments": ...}, а не передаются как ошибки протокола.

Структура проекта

tradingview_mcp/
├── src/mcp_tradingview/
│   ├── __init__.py      # métadonnées du paquet (__version__)
│   ├── __main__.py      # entrée `python -m mcp_tradingview`
│   ├── config.py        # settings (pydantic-settings, préfixe TV_)
│   ├── models.py        # schémas Pydantic d'entrée / sortie
│   ├── client.py        # client TradingView, indicateurs, cache TTL
│   ├── tools.py         # définition JSON Schema + dispatch des outils
│   └── server.py        # serveur MCP (stdio + SSE) et entrée console
├── tests/
│   └── test_server.py
├── pyproject.toml
├── .env.example
├── .gitignore
├── LICENSE
└── README.md

Лицензия

Распространяется под лицензией MIT. См. файл LICENSE.