greenpeas007/tradingview-mcp-jackson
요약
TradingView Desktop 앱과 Claude를 연결하여 트레이딩 워크플로우를 자동화하는 MCP(Model Context Protocol) 서버 구현체입니다. 모닝 브리프 생성, 규칙 기반 데이터 분석, 세션 저장 기능을 통해 Claude가 시장 데이터를 읽고 분석할 수 있도록 지원합니다.
핵심 포인트
- TradingView Desktop 데이터를 Claude와 연동하는 MCP 서버
- 모닝 브리프 및 규칙 기반(rules.json) 자동 분석 기능 제공
- Chrome DevTools Protocol을 이용한 로컬 데이터 처리로 보안 강화
- Claude Code를 통한 간편한 설치 및 설정 지원
YouTube 영상을 통해 이곳을 찾으셨다면 환영합니다. 이것은 개선된 포크 (fork) 버전입니다. 필요한 모든 정보는 아래에 있습니다.
@tradesdontlie의 원본 tradingview-mcp를 기반으로 구축되었습니다. 기반을 마련해 준 그들에게 모든 공로를 돌립니다. 이 포크 버전은 모닝 브리프 (morning brief) 워크플로우, 규칙 설정 (rules config) 기능을 추가하였으며, TradingView Desktop v2.14+ 버전에서의 실행 버그를 수정했습니다.
경고
TradingView Inc. 또는 Anthropic과 관련이 없습니다. 이 도구는 Chrome DevTools Protocol을 통해 로컬에서 실행 중인 TradingView Desktop 앱에 연결합니다. 사용 전 면책 조항 (Disclaimer)을 검토하십시오.
중요
유효한 TradingView 구독이 필요합니다. 이 도구는 TradingView의 유료 결제 장벽 (paywall)을 우회하지 않습니다. 이 도구는 이미 귀하의 컴퓨터에서 실행 중인 TradingView Desktop 앱으로부터 데이터를 읽고 이를 제어합니다.
참고
모든 데이터 처리는 로컬에서 이루어집니다. 어떤 데이터도 외부로 전송되지 않습니다. TradingView 데이터는 귀하의 컴퓨터를 떠나지 않습니다.
| 기능 | 역할 |
|---|---|
morning_brief | 하나의 명령어로 관심 종목 (watchlist)을 스캔하고, 모든 지표 (indicators)를 읽어 Claude가 세션 편향 (session bias)을 생성할 수 있도록 구조화된 데이터를 반환합니다 |
session_save / session_get | 일일 브리프를 ~/.tradingview-mcp/sessions/에 저장하여 오늘과 어제를 비교할 수 있게 합니다 |
rules.json | 편향 기준, 리스크 규칙, 관심 종목 등 거래 규칙을 한 번만 작성하십시오. 모닝 브리프가 매일 이를 자동으로 적용합니다 |
| 실행 버그 수정 | TradingView Desktop v2.14+와의 tv_launch 호환성을 수정했습니다 |
tv brief CLI | 터미널에서 한 단어로 모닝 브리프를 실행합니다 |
다음 내용을 Claude Code에 붙여넣으면 모든 과정을 처리해 줍니다:
Set up TradingView MCP Jackson for me.
Clone https://github.com/LewisWJackson/tradingview-mcp-jackson.git to ~/tradingview-mcp-jackson, 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-jackson/src/server.js"] } } } — replace YOUR_USERNAME with my actual username.
...
또는 아래의 수동 단계를 따르세요.
TradingView 데스크톱 앱 (실시간 데이터를 위해 유료 구독 필요)
Node.js 18+
Claude Code (MCP 도구용) 또는 모든 터미널 (CLI용)
macOS, Windows, 또는 Linux
git clone https://github.com/LewisWJackson/tradingview-mcp-jackson.git ~/tradingview-mcp-jackson
cd ~/tradingview-mcp-jackson
npm install
cp rules.example.json rules.json
rules.json을 열고 다음 내용을 채우세요:
- 귀하의 관심 종목 목록 (watchlist) (매일 아침 스캔할 심볼)
- 귀하의 편향 기준 (bias criteria) (무엇이 귀하에게 강세/약세/중립을 만드는지)
- 귀하의 리스크 규칙 (risk rules) (Claude가 매 세션 전에 확인하기를 원하는 규칙)
TradingView는 디버그 포트 (debug port)가 활성화된 상태로 실행 중이어야 합니다.
Mac:
./scripts/launch_tv_debug_mac.sh
Windows:
scripts\launch_tv_debug.bat
Linux:
./scripts/launch_tv_debug_linux.sh
또는 설정 후 MCP 도구를 사용하세요: "Use tv_launch to start TradingView in debug mode"
~/.claude/.mcp.json에 추가하세요
(기존 서버가 있다면 병합하세요):
{
"mcpServers": {
"tradingview": {
...
YOUR_USERNAME을 실제 사용자 이름으로 교체하세요. Mac의 경우 echo $USER를 입력하여 확인할 수 있습니다.
Claude Code를 재시작한 후 다음과 같이 물어보세요: "Use tv_health_check to verify TradingView is connected"
Claude에게 요청하세요: "Run morning_brief and give me my session bias"
또는 터미널에서 실행하세요:
npm link # tv CLI를 전역(globally)으로 설치 (1회 수행)
tv brief
이것은 이 도구를 단순한 툴킷에서 일상적인 습관으로 바꿔주는 기능입니다.
매 세션 시작 전:
- TradingView가 열려 있어야 함 (디버그 포트와 함께 실행됨)
- 터미널에서 다음을 실행하거나 Claude에게 요청하세요:
tv brief(또는"run morning_brief"라고 요청) - Claude는 귀하의 관심 종목 목록(watchlist)에 있는 모든 심볼을 스캔하고, 지표(indicator) 값을 읽고, 귀하의
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
...
- 내용을 저장하세요:
"save this brief"(session_save사용)
) - 다음 날 아침, 비교:
"yesterday's session 가져오기" (session_get 사용)
Morning brief (아침 브리핑)— 관심 종목 스캔, 지표 읽기, 규칙 적용, 세션 편향 (session bias) 출력
Pine Script 개발— AI를 사용하여 스크립트 작성, 주입, 컴파일, 디버깅
차트 탐색— 심볼 변경, 타임프레임 (timeframes) 변경, 날짜 확대/축소, 지표 추가/제거
시각적 분석— 지표 값, 가격 레벨, 커스텀 지표에서 그려진 레벨 읽기
차트에 그리기— 추세선 (trend lines), 수평 레벨 (horizontal levels), 사각형, 텍스트
알림 관리— 가격 알림 생성, 목록 표시, 삭제
리플레이 연습— 과거 봉(bars)을 단계별로 진행하며 손익 (P&L) 추적과 함께 진입 및 청산 연습
스크린샷— 차트 상태 캡처
멀티 페인 레이아웃 (Multi-pane layouts)— 각 페인마다 다른 심볼을 사용하는 2x2, 3x1 그리드
데이터 스트리밍— 스크립트 모니터링을 위한 라이브 차트의 JSONL 출력
CLI 액세스— 모든 도구는 tv 명령어로도 사용 가능하며, 파이프 (pipe) 연결에 용이한 JSON 출력을 제공합니다.
Claude는 이 프로젝트에서 작업할 때 CLAUDE.md를 자동으로 읽습니다. 여기에는 전체 결정 트리 (decision tree)가 포함되어 있습니다.
| 당신이 말하면... | Claude가 사용하는 것... |
|---|---|
| "Run my morning brief" | morning_brief → 규칙 적용 → session_save |
| ... | |
| 도구 (Tool) | 기능 |
| --- | --- |
morning_brief | 관심 종목 스캔, 지표 읽기, 세션 편향을 위한 구조화된 데이터 반환. rules.json을 자동으로 읽음. |
session_save | 생성된 브리핑을 ~/.tradingview-mcp/sessions/YYYY-MM-DD.json에 저장 |
session_get | 오늘의 브리핑 가져오기 (오늘 것이 아직 저장되지 않았다면 어제의 것 가져오기) |
| 도구 (Tool) | 사용 시점 | 출력 크기 |
|---|---|---|
chart_get_state | 첫 번째 호출 — 심볼, 타임프레임, 모든 지표 이름 + ID 가져오기 | ~500B |
data_get_study_values | 모든 지표에서 현재 RSI, MACD, BB, EMA 값 읽기 | ~500B |
quote_get | 최신 가격, OHLC, 거래량 가져오기 | ~200B |
data_get_ohlcv | 가격 봉(bars) 가져오기. 요약 통계를 위해 summary: true 사용 | 500B (요약) / 8KB (100개 봉) |
가시적인 모든 Pine 지표로부터 line.new(), label.new(), table.new(), box.new() 출력을 읽습니다.
| 도구 (Tool) | 사용 시점 |
|---|---|
data_get_pine_lines | |
| 수평 가격 레벨 (지지/저항, 세션 레벨) | |
data_get_pine_labels | |
| 텍스트 주석 + 가격 ("PDH 24550", "Bias Long") | |
data_get_pine_tables | |
| 데이터 테이블 (세션 통계, 분석 대시보드) | |
data_get_pine_boxes | |
| {high, low} 쌍으로 표현된 가격 구역 (Price zones) |
특정 지표를 타겟팅하려면 항상 study_filter를 사용하세요:
study_filter: "MyIndicator"
.| 도구 (Tool) | 기능 |
|---|---|
chart_set_symbol |
티커 변경 (BTCUSD, AAPL, ES1!, NYMEX:CL1!)
chart_set_timeframe |
해상도 (Resolution) 변경 (1, 5, 15, 60, D, W, M)
chart_set_type |
스타일 변경 (Candles, HeikinAshi, Line, Area, Renko)
chart_manage_indicator |
지표 추가/제거. 전체 이름을 사용하세요: "RSI"가 아닌 "Relative Strength Index"
chart_scroll_to_date |
특정 날짜로 이동 (ISO 형식: "2025-01-15")
indicator_set_inputs / indicator_toggle_visibility |
지표 설정 변경, 표시/숨기기
| 도구 (Tool) | 단계 |
|---|---|
pine_set_source |
- 에디터에 코드 주입 (Inject)
pine_smart_compile| - 자동 감지 + 오류 체크와 함께 컴파일 (Compile)
pine_get_errors| - 오류가 있는 경우 컴파일 오류 읽기
pine_get_console| - log.info() 출력 읽기
pine_save| - TradingView 클라우드에 저장
pine_analyze|
오프라인 정적 분석 (차트 불필요)
pine_check|
서버 측 컴파일 체크 (차트 불필요)
| 도구 (Tool) | 단계 |
|---|---|
replay_start | |
| 특정 날짜에서 리플레이 (Replay) 시작 | |
replay_step | |
| 한 봉 (Bar) 진행 | |
replay_autoplay | |
| 자동 진행 (ms 단위로 속도 설정) | |
replay_trade | |
| 포지션 매수/매도/종료 | |
replay_status | |
| 포지션, 손익 (P&L), 날짜 확인 | |
replay_stop | |
| 실시간 상태로 복귀 |
| 도구 (Tool) | 기능 |
|---|---|
pane_set_layout | |
그리드 변경: s , 2h , 2v , 2x2 , 4 , 6 , 8 | |
pane_set_symbol | |
| 모든 창(pane)에 심볼(symbol) 설정 | |
draw_shape | |
| 수평선 (horizontal_line), 추세선 (trend_line), 사각형 (rectangle), 텍스트 (text) 그리기 | |
alert_create / alert_list / alert_delete | |
| 가격 알림 (price alerts) 관리 | |
batch_run | |
| 여러 심볼/타임프레임 (timeframes)에 걸쳐 작업 실행 | |
watchlist_get / watchlist_add | |
| 관심종목 리스트 (watchlist) 읽기/수정 | |
capture_screenshot | |
| 스크린샷 (영역: 전체, 차트, 전략 테스터 (strategy_tester)) | |
tv_launch / tv_health_check | |
| TradingView 실행 및 연결 확인 |
tv brief # 모닝 브리프 (morning brief) 실행
tv session get # 오늘 저장된 브리프 가져오기
tv session save --brief "..." # 브리프 저장
...
전체 명령 목록: tv --help
| 문제 (Problem) | 해결책 (Solution) |
|---|---|
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 — 관심종목 리스트가 비어 있음 | |
rules.json의 watchlist 배열에 심볼을 추가하세요. | |
| 도구가 오래된 데이터를 반환함 | TradingView가 아직 로딩 중입니다 — 몇 초간 기다리세요. |
| Pine Editor 도구 실패 | Pine Editor 패널을 먼저 여세요: ui_open_panel pine-editor open |
Claude Code ←→ MCP 서버 (stdio) ←→ CDP (port 9222) ←→ TradingView Desktop (Electron)
78개의 오리지널 도구 + 3개의 모닝 브리프 도구 = 총 81개의 MCP 도구
전송 (Transport): stdio 기반의 MCP + CLI (tv 명령어)
연결 (Connection): localhost:9222의 Chrome DevTools Protocol (CDP)
외부 네트워크 호출 없음 — 모든 작업은 로컬에서 실행됩니다.
추가 의존성 없음 — 오리지널 외에는 추가적인 의존성이 없습니다.
이 포크(fork) 버전은 @tradesdontlie의 tradingview-mcp를 기반으로 구축되었습니다. 오리지널 도구가 토대이므로, 해당 저장소에 별(star)을 눌러주세요.
이 프로젝트는 개인적, 교육적 및 연구 목적으로만 제공됩니다.
이 도구는 모든 Chromium 기반 애플리케이션에 내장된 표준 디버깅 인터페이스인 Chrome DevTools Protocol (CDP)을 사용합니다. 이 도구는 TradingView의 독점 프로토콜을 역공학 (Reverse Engineering) 하거나, TradingView 서버에 연결하거나, 어떠한 액세스 제어도 우회하지 않습니다. 디버그 포트 (Debug port)는 사용자가 표준 Chromium 명령줄 플래그 (Command-line flag)를 통해 명시적으로 활성화해야 합니다.
이 소프트웨어를 사용함으로써 귀하는 다음 사항에 동의하게 됩니다:
- 귀하는 귀하의 사용이 TradingView의 이용 약관 (Terms of Use) 및 모든 관련 법률을 준수하는지 확인해야 할 단독 책임이 있습니다.
- 이 도구는 언제든지 변경될 수 있는 문서화되지 않은 TradingView 내부 API에 액세스합니다.
- 이 도구는 TradingView의 시장 데이터를 재배포, 재판매 또는 상업적으로 이용하는 데 사용되어서는 안 됩니다.
- 저자들은 계정 정지, 중지 또는 기타 결과에 대해 책임을 지지 않습니다.
사용에 따른 위험은 사용자 본인에게 있습니다.
MIT — LICENSE를 참조하십시오. 소스 코드에만 적용되며, TradingView의 소프트웨어, 데이터 또는 상표에는 적용되지 않습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기