AI 어시스턴트용 TradingView MCP 시장 데이터 및 기술 분석

TradingView MCP 서버 — Claude, ChatGPT, Cursor, Copilot 및 모든 MCP 클라이언트를 위한 실시간 시장 데이터, 기술 지표, 스크리너 및 백테스팅. 글로벌 거래소의 주식, 암호화폐, 외환 및 선물. 백테스팅 + 실시간 심리 + Yahoo Finance + 37가지 기술 분석 도구 — 가장 완벽한 TradingView MCP 툴킷, 하나의 서버에 모두 포함.

🆕 호스팅 서버가 이제 차트를 그립니다. 차트를 요청하면 대화형 캔들스틱 뷰(1d / 1h / 15m, 선택적 Bollinger 오버레이)가 MCP Apps를 통해 대화 내에서 실시간으로 렌더링됩니다 — 그리고 AI가 밴드 값을 다시 읽어드립니다:

URL 하나를 붙여넣거나(pip install) 그냥 물어보세요. 실시간 서버에서 바로 나오는 실제 출력:

이것부터 시도해 보세요 — Claude, ChatGPT, Cursor 또는 모든 MCP 클라이언트에서 작동합니다:

Show today's top crypto gainers on Binance
Run a full technical analysis of NVDA
What's the multi-timeframe read on gold?
Backtest an RSI strategy on BTC on the daily timeframe

[!NOTE] 독립적인 오픈소스 프로젝트 — TradingView Inc.와 제휴, 보증 또는 관련이 없습니다. "TradingView"는 해당 소유자의 상표입니다. 이 프로젝트는 제3자 시장 데이터를 사용하며 TradingView 제품이 아닙니다.

[!NOTE] TradingView 계정이 필요하거나 위험에 노출되나요? 아니요. 이 서버는 TradingView 세션에 로그인하거나, 스크래핑하거나, 자동화하지 않으며 TradingView 계정이나 API 키가 필요하지 않습니다. 시장 데이터는 공개 엔드포인트에서 서버 측에서 가져오므로, 여러분의 계정이 관여하지 않으며 브라우저/UI 자동화도 없습니다. (Chrome DevTools를 통해 TradingView 데스크톱 앱을 구동하는 MCP 서버와는 다릅니다.) 사용하는 데이터 소스의 약관을 준수하는 것은 사용자 본인의 책임입니다.

"TradingView MCP"는 이제 두 가지 매우 다른 종류의 프로젝트를 의미합니다. 둘 다 유용합니다 — 서로 다른 작업에 적합합니다:

여러분의 TradingView 데스크톱에서 AI가 클릭하며 작업하기를 원한다면 — Pine Script 편집, 차트 그리기, 리플레이 사용 — tradesdontlie/tradingview-mcp를 확인하세요. 헤드리스 시장 데이터, 스크리너 및 백테스팅을 설치 없이, TradingView 계정 없이 모든 AI 클라이언트에서 사용하려면 — 이 프로젝트입니다.

[!IMPORTANT] 투자 조언이 아닙니다. 이 소프트웨어가 생성하는 모든 것은 투자, 재무, 법률, 세금 또는 회계 조언이 아닙니다. tradingview-mcp는 정보 제공 및 교육용 분석 도구입니다. 지표, 점수, 신호, "매매 설정", 진입가, 손절가 및 목표가를 포함한 출력은 제3자 시장 데이터에서 계산되며 어떤 자산의 매수, 매도 또는 보유를 권장하지 않습니다. 거래를 실행하거나, 자금을 관리하거나, 어떤 결과도 보장하지 않습니다. 거래와 투자는 상당한 손실 위험을 수반하며, 자본의 일부 또는 전부를 잃을 수 있습니다. 항상 스스로 조사하고 재정적 결정을 내리기 전에 면허를 가진 전문가와 상담하세요. 모든 결정과 적용되는 법률 및 규정을 준수할 책임은 전적으로 사용자 본인에게 있습니다. 시장 데이터는 지연되거나, 부정확하거나, 불완전할 수 있으며 보증 없이 제공됩니다.

[!TIP] 설정이 필요 없나요? 호스팅 버전을 사용하세요. pro.cryptosieve.com은 Claude.ai, ChatGPT, Copilot 및 Cursor를 위한 하나의 커넥터 URL로 37개 도구를 모두 제공합니다 — uv, pandas 또는 Python을 다룰 필요가 없습니다. 월 $9(Pro) 또는 월 $29(Pro+ — 더 높은 한도)부터, 3일 무료 체험 포함. 자체 호스팅은 영원히 무료로 유지됩니다. 호스팅은 운영을 건너뛰고 싶은 분들을 위한 것입니다. (전체 자체 호스팅 vs 호스팅 비교는 아래 Quick Start에서 확인하세요.)

⭐ 이 도구가 여러분의 워크플로우를 개선한다면, 저장소에 스타를 남기고 스폰서가 되어 주세요 — 프로젝트를 살아있고 성장하게 유지합니다!

🎥 프레임워크 데모

https://github-production-user-asset-6210df.s3.amazonaws.com/67838093/478689497-4a605d98-43e8-49a6-8d3a-559315f6c01d.mp4

Related MCP server: FinanceKit MCP

🆕 새로운 기능

안정성 및 전략 확장 (2026년 5월)

• 비동기 핫패스 도구 — 7개의 트래픽이 많은 도구(yahoo_price, stock_extended_hours, top_gainers, volume_breakout_scanner, multi_timeframe_analysis, financial_news, combined_analysis)가 async def로 변환되었습니다. FastMCP는 동기 도구를 이벤트 루프에서 직렬로 실행합니다 — 비동기는 실제 서버 내 병렬 처리를 열어 동시 도구 호출이 실제로 겹칠 수 있게 합니다. combined_analysis는 추가로 3개의 하위 호출을 asyncio.gather로 분산하여 강력한 도구에서 약 3배의 벽시계 시간 개선을 제공합니다. yahoo_price / stock_extended_hours는 httpx.AsyncClient를 사용하여 진정한 비차단 I/O를 구현합니다. 동기 라이브러리 도구(tradingview_ta, tradingview-screener, feedparser)는 asyncio.to_thread를 통해 오프로드됩니다. (PR — 오픈)

• 9가지 백테스트 전략 (6개에서 증가) — rsi_pullback, keltner_breakout, triple_ema 추가: 추세-풀백, ATR 정규화 돌파, SMA200 필터 EMA 크로스 엣지. compare_strategies가 이제 전체 9개를 순위화합니다.

• 복원력 계층 — TradingView 스크리너 제공자에 자동 재시도 + 60초 TTL 캐시, combined_analysis 및 multi_timeframe_analysis의 일시적인 "Expecting value" 오류 제거. (PR #32 — 병합됨)

• 금융 뉴스 서비스 재구축 — 폐기된 Reuters RSS 엔드포인트를 Yahoo Finance, MarketWatch 및 CNBC로 대체. financial_news의 오래된 count: 0 버그 수정. (PR #33 — 병합됨)

• TA 스로틀 — 동시 tradingview_ta 호출 제한(기본 4) + 시작 간 최소 0.8초 간격. combined_analysis / multi_timeframe_analysis의 병렬 버스트가 TradingView의 빈 본문 속도 제한 절벽에 부딪히는 것을 방지. 환경 변수로 조정 가능. (PR #34 — 병합됨)

• 워크포워드 백테스팅 (walk_forward_backtest_strategy) — 과적합 판정(ROBUST / MODERATE / WEAK / OVERFITTED)이 포함된 훈련/테스트 분할.

• 시간별(1h) 타임프레임 지원 — backtest_strategy, compare_strategies, walk_forward_backtest_strategy 전반에 걸쳐.

• 전체 거래 로그 + 자본 곡선 출력 (include_trade_log=True, include_equity_curve=True).

🏗️ 아키텍처

✨ 왜 tradingview-mcp인가?

🚀 빠른 시작 (5분)

두 가지 실행 방법 — 어느 쪽이든 동일한 37개 도구:

☁️ 제로 셋업: 커넥터 URL 하나를 Claude.ai, ChatGPT, Copilot 또는 Cursor에 붙여넣기만 하세요 → 3일 무료 체험 시작. 아래 내용은 모두 셀프호스팅용입니다.

pip로 설치

pip install tradingview-mcp-server

선택 사항: 뉴스 및 감성 분석 (무료 Marketaux 키)

financial_news와 market_sentiment(그리고 combined_analysis의 뉴스/감성 부분)는 Marketaux가 제공합니다 — 엔티티별 감성 분석이 포함된 라이선스 시장 뉴스입니다. 무료 API 키(하루 100회 요청; 서버가 4시간 캐시하고 뉴스와 감성 분석이 하나의 fetch를 공유하므로 무료 티어로 충분합니다)를 받아서 설정하세요:

export MARKETAUX_API_TOKEN=your_token_here   # optional

토큰이 없으면 이 두 도구는 친절한 "미구성" 안내를 반환합니다 — 다른 모든 도구는 정상 작동합니다.

Claude Desktop 설정 (claude_desktop_config.json)

참고: macOS에서 Claude Desktop 같은 GUI 앱은 PATH에 ~/.local/bin이 없을 수 있습니다. "command not found" 오류를 피하려면 uvx의 전체 경로를 사용하세요.

{
  "mcpServers": {
    "tradingview": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uvx",
      "args": ["--from", "tradingview-mcp-server", "tradingview-mcp"]
    }
  }
}

Linux에서는 /Users/YOUR_USERNAME을 /home/YOUR_USERNAME으로 바꾸세요. Windows에서는 %USERPROFILE%\.local\bin\uvx.exe를 사용하세요.

Codex 플러그인 설정

이 저장소에는 mcp 전용 Codex 플러그인 메타데이터도 포함되어 있습니다:

• .codex-plugin/plugin.json

• .codex-mcp.json

플러그인은 동일한 PyPI 패키지 엔트리포인트를 사용합니다:

{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": ["--from", "tradingview-mcp-server", "tradingview-mcp"]
    }
  }
}

Codex 플러그인을 설치하거나 활성화한 후 Codex를 재시작하면 다음 세션에서 MCP 서버가 로드됩니다. Codex 버전에 따라 codex mcp list에 등록된 MCP 서버가 표시될 수 있지만, 도구 사용 가능 여부는 새 Codex 세션에서 확인해야 합니다.

또는 소스에서 실행

git clone https://github.com/atilaahmettaner/tradingview-mcp
cd tradingview-mcp
uv run tradingview-mcp

🛠️ 문제 해결

🪟 Windows: 첫 실행 시 MCP error -32001: Request timed out

증상 — 설정을 추가한 직후 Claude Desktop 로그에 다음과 같은 메시지가 표시됩니다:

[tradingview] Server started and connected successfully
[tradingview] Message from client: initialize ...
[60 seconds later]
[tradingview] notifications/cancelled — reason: "MCP error -32001: Request timed out"

원인: Python 3.14는 아직 지원되지 않습니다. uvx가 tradingview-mcp-server를 다운로드하고, 새 virtualenv를 만들고, 처음 실행할 때 의존성을 설치합니다. MCP 스택의 일부 네이티브 의존성이 현재 호환되는 Python 3.14 wheel을 제공하지 않아 설치가 소스 빌드로 대체되거나 Claude Desktop이 서버 초기화를 마치기 전에 실패할 수 있습니다.

해결책 — Python 3.13으로 고정(사전 빌드된 pandas wheel 있음):

{
  "mcpServers": {
    "tradingview": {
      "command": "uvx",
      "args": ["--python", "3.13", "--from", "tradingview-mcp-server", "tradingview-mcp"]
    }
  }
}

macOS에서는 uvx의 전체 경로를 사용하세요(Quick Start의 참고 참조). Windows에서 uvx는 일반적으로 %USERPROFILE%\.local\bin\uvx.exe입니다.

대안 — 한 번 사전 설치한 후 Claude Desktop이 캐시를 재사용하도록 하기:

# Run in a terminal before launching Claude Desktop
uv tool install --python 3.13 tradingview-mcp-server

설치가 끝나면 일반 설정으로 Claude Desktop을 시작하면 서버가 즉시 뜹니다(캐시가 이미 준비되어 있음).

출처: @wyh4444 — #24의 원래 보고.

⚠️ 오류 봉투 형식

구조화된 오류 형식을 채택한 도구는 정상 페이로드 또는 오류 봉투를 반환합니다:

{"error": {"code": "ALL_BATCHES_FAILED", "message": "All 5 batches failed; first error: JSONDecodeError(...)", "batches_attempted": 5, "batches_failed": 5, "first_error": "...", "retryable": true}}

이유: 기존 [] / {"error": "Analysis failed: ..."} 문자열은 "오늘 일치 없음"과 "업스트림 속도 제한 절벽"을 구분할 수 없게 만들었습니다. 새 봉투는 code로 프로그래밍 방식으로 분기할 수 있고, retryable은 대기 후 재시도가 도움이 되는지 호출자에게 알려줍니다(업스트림 폭풍은 지나갑니다; 누락된 의존성은 스스로 고쳐지지 않습니다).

전체 적용(모든 실패 모드 — 업스트림 중단, 빈 심볼 목록, 누락된 의존성, 예상치 못한 예외 — 원시 문자열/트레이스백 대신 봉투를 반환): top_gainers, top_losers, bollinger_scan, rating_filter, volume_breakout_scanner, smart_volume_scanner.

부분 적용(주요 오류 경로가 봉투를 반환): coin_analysis, volume_confirmation_analysis, consecutive_candles_scan, futures_market_overview, futures_top_movers, stock_prices, 그리고 백테스트 입력 가드. 나머지 도구는 배치로 마이그레이션됩니다 — #76에서 추적.

오류 감지:

result = volume_breakout_scanner(exchange="KUCOIN")
if isinstance(result, dict) and "error" in result:
    code = result["error"]["code"]
    if result["error"].get("retryable"):
        # Wait + retry, raise alert, fall back to single-batch call, etc.
        ...
else:
    for row in result:
        ...

안정적인 코드는 core/errors.py에 정의되어 있습니다.

📱 Telegram, WhatsApp 등에서 사용 (OpenClaw)

이 서버를 Telegram, WhatsApp, Discord 및 20개 이상의 메시징 플랫폼에 연결하세요 — OpenClaw — 셀프호스팅 AI 게이트웨이. Hetzner VPS(Ubuntu 24.04)에서 테스트 및 검증 완료.

작동 방식

OpenClaw는 Telegram 메시지를 AI 에이전트로 라우팅합니다. 에이전트는 trading.py — 가벼운 Python 래퍼 — 를 사용하여 tradingview-mcp 함수를 호출하고 형식화된 결과를 반환합니다. OpenClaw와 서버 사이에 MCP 프로토콜이 필요 없습니다; 직접 Python import입니다.

Telegram → OpenClaw agent (AI model) → trading.py (bash) → tradingview-mcp → Yahoo Finance

빠른 설정

# 1. Install UV and tradingview-mcp
curl -LsSf https://astral.sh/uv/install.sh | sh && source ~/.bashrc
uv tool install tradingview-mcp-server

# 2. Configure OpenClaw channels
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  channels: {
    telegram: {
      botToken: "YOUR_BOT_TOKEN_HERE",
    },
  },
}
EOF

# 3. Configure gateway + agent
openclaw config set gateway.mode local
openclaw config set acp.defaultAgent main

# 4. Set your AI model (choose ONE option below)
openclaw configure --section model

# 5. Install the skill + tool wrapper
mkdir -p ~/.agents/skills/tradingview-mcp ~/.openclaw/tools
curl -fsSL https://raw.githubusercontent.com/atilaahmettaner/tradingview-mcp/main/openclaw/SKILL.md \
  -o ~/.agents/skills/tradingview-mcp/SKILL.md
curl -fsSL https://raw.githubusercontent.com/atilaahmettaner/tradingview-mcp/main/openclaw/trading.py \
  -o ~/.openclaw/tools/trading.py && chmod +x ~/.openclaw/tools/trading.py

# 6. Start the gateway
openclaw gateway install
systemctl --user start openclaw-gateway.service

AI 모델 선택

OpenRouter는 필수 아님 — 키가 있는 어떤 제공자든 사용하세요:

# Examples — set your chosen model:
openclaw config set agents.defaults.model "openrouter/google/gemini-3-flash-preview"  # via OpenRouter
openclaw config set agents.defaults.model "anthropic/claude-sonnet-4-5"               # Anthropic direct
openclaw config set agents.defaults.model "google/gemini-2.5-flash"                   # Google direct

⚠️ 중요: 접두사는 제공자와 일치해야 합니다. google/...는 Google API 키가 필요합니다. openrouter/...는 OpenRouter 키가 필요합니다.

⚠️ 흔한 실수

봇 테스트

실행되면 텔레그램 봇에 보내세요:

market snapshot
backtest RSI strategy for AAPL, 1 year
compare all strategies for BTC-USD

👉 전체 OpenClaw 설정 가이드 →

기본 스크리너와 달리 이 프레임워크는 전문 AI 에이전트를 배치하여 실시간으로 결과를 토론합니다:

1. 🛠️ 기술 분석가 — 볼린저 밴드(±3 독점 등급), RSI, MACD

2. 🌊 감성 및 모멘텀 분석가 — Reddit 커뮤니티 감성 + 가격 모멘텀

3. 🛡️ 리스크 관리자 — 변동성, 하락 리스크, 평균 회귀 신호

출력: STRONG BUY / BUY / HOLD / SELL / STRONG SELL + 신뢰도 점수

🔧 전체 37개 MCP 도구

📊 백테스팅 엔진

테스트할 9가지 전략:

• rsi — RSI 과매도/과매수 평균 회귀

• bollinger — 볼린저 밴드 평균 회귀

• macd — MACD 골든/데스 크로스

• ema_cross — EMA 20/50 골든/데스 크로스

• supertrend — ATR 기반 Supertrend 추세 추종 🔥

• donchian — Donchian 채널 돌파 (Turtle Trader 스타일)

• rsi_pullback — 확인된 상승 추세에서 딥 매수 (SMA50>SMA200 + RSI<40 진입) 🆕

• keltner_breakout — ATR 정규화 돌파 (EMA20 + 2·ATR 상단 밴드) 🆕

• triple_ema — SMA200 추세 필터로 게이트된 EMA 20/50 크로스 🆕

🆕 전략은 period='1y' 또는 '2y'가 필요합니다 — SMA200 추세 필터가 워밍업을 완료할 수 있도록.

얻는 지표: 승률, 총 수익률, Sharpe 비율, Calmar 비율, 최대 하락폭, 이익 계수, 기대값, 최고/최저 거래, 매수 후 보유 대비, 현실적인 수수료 + 슬리피지 시뮬레이션 포함.

Example prompt: "Compare all 9 strategies on MSFT for 2 years"
→ #1 triple_ema:        +15.1% | Sharpe:  0.0 | WR: 100%
→ #2 keltner_breakout:  +14.3% | Sharpe:  4.7 | WR:  40%
→ #3 bollinger:         +12.2% | Sharpe:  4.1 | WR:  64%
→ Buy & Hold:            -2.1%

💰 Yahoo Finance — 실시간 가격 (v0.6.0의 신규)

지원: 주식 (AAPL, TSLA, NVDA), 암호화폐 (BTC-USD, ETH-USD, SOL-USD), ETF (SPY, QQQ, GLD), 지수 (^GSPC, ^DJI, ^IXIC, ^VIX), 외환 (EURUSD=X), 터키 (THYAO.IS, SASA.IS)

🌍 글로벌 주식 스크리너 — 보통주 및 우선주

🧠 AI 감성 및 인텔리전스

📈 기술적 분석 핵심

🌍 다중 거래소 지원

💬 AI 대화 예시

You: "Give me a full market snapshot right now"
AI: [market_snapshot] → S&P500 -3.4%, BTC +0.1%, VIX 31 (+13%), EUR/USD 1.15

You: "What is Reddit saying about NVDA?"
AI: [market_sentiment] → Strongly Bullish (0.41) | 23 posts | 18 bullish

You: "Backtest RSI strategy on BTC-USD for 2 years"
AI: [backtest_strategy] → +31.5% return | 100% win rate | 2 trades | B&H: -5%

You: "Which of the 9 strategies worked best on MSFT in the last 2 years?"
AI: [compare_strategies] → triple_ema #1 (+15.1%, WR 100%), keltner_breakout #2 (+14.3%), macd last (-23.4%)

You: "Run walk-forward backtest on supertrend for SPY"
AI: [walk_forward_backtest_strategy] → Verdict: ROBUST (avg robustness 0.92) | OOS return +8.5%

You: "Analyze TSLA with all signals: technical + sentiment + news"
AI: [combined_analysis] → BUY (Technical STRONG BUY + Bullish Reddit + Positive news)

💖 프로젝트 후원

이 프레임워크는 무료 오픈소스이며 여가 시간에 만들어졌습니다. 조사 시간을 절약해 주거나 더 나은 결정을 내린 느끼게 해 주었다면, 후원을 고려해 주세요:

모든 후원은 Walk-Forward 백테스팅, Twitter/X 시장 걱성 분석, 관리형 클라우드 호스팅 같은 새로운 기능 개발에 직접 쓰입니다.

📋 로드맵

• TradingView 기술적 분석 (30개 이상 지표)

• 다중 거래소 스크리너 (Binance, KuCoin, MEXC, EGX, 미국 주식)

• Reddit 감정 분석

• 실시간 금융 뉴스 (Yahoo / MarketWatch / CNBC / CoinDesk / CoinTelegraph)

• Yahoo Finance 실시간 가격

• 백테스팅 엔진 (9가지 전략 + Sharpe / Calmar / 기대치)

• 워크포워드 백테스팅 (과최적화 감지)

• 스크리너 제공자에 대한 복원 계층 (retry + TTL 캐시)

• 시간봉(1h) 백테스팅 타임프레임

• Twitter/X 시장 감성

• 가상 거래 시뮬레이션

• 관리형 클라우드 호스팅 (로컬 설치 불필요)

📄 라이선스

MIT License — 자세한 내용은 LICENSE를 확인하세요.

면책 조항: 이 도구는 교육 및 연구 목적으로만 제공됩니다. 투자 조언에 해당하지 않습니다. 투자 결정을 내리기 전에 항상 스스로 조사하세요.