TradingView MCP Jackson

YouTube 영상에서 이곳을 찾아오셨다면 — 환영합니다. 이것은 개선된 포크(fork)입니다. 필요한 모든 것이 아래에 있습니다.

원본 tradingview-mcp을 기반으로 제작되었으며, @tradesdontlie 님의 작품입니다. 기반을 만들어 주신 데 대해 전적으로 크레딧을 드립니다. 이 포크는 모닝 브리프(morning brief) 워크플로우, 규칙 설정 파일, 그리고 TradingView Desktop v2.14+의 실행 버그 수정을 추가합니다.

[!WARNING] TradingView Inc. 또는 Anthropic과 관련이 없습니다. 이 도구는 Chrome DevTools Protocol을 통해 로컬에서 실행 중인 TradingView Desktop 앱에 연결합니다. 사용 전에 면책 조항을 검토하세요.

[!IMPORTANT] 유효한 TradingView 구독이 필요합니다. 이 도구는 TradingView의 유료 콘텐츠 차단을 우회하지 않습니다. 사용자 머신에서 이미 실행 중인 TradingView Desktop 앱을 읽고 제어할 뿐입니다.

[!NOTE] 모든 데이터 처리는 로컬에서 이루어집니다. 어떤 것도 외부로 전송되지 않습니다. TradingView 데이터는 사용자 머신을 벗어나지 않습니다.

이 포크의 새로운 기능

Related MCP server: TVControl

원샷(One-Shot) 설정

이 내용을 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.
Then copy rules.example.json to rules.json and open it so I can fill in my trading rules.
Finally restart and verify with tv_health_check.

또는 아래의 수동 단계를 따르세요.

사전 요구 사항

• TradingView Desktop 앱 (실시간 데이터에는 유료 구독 필요)

• Node.js 18+

• Claude Code (MCP 도구용) 또는 모든 터미널 (CLI용)

• macOS, Windows, Linux

빠른 시작

1. 클론 및 설치

git clone https://github.com/LewisWJackson/tradingview-mcp-jackson.git ~/tradingview-mcp-jackson
cd ~/tradingview-mcp-jackson
npm install

2. 규칙 설정

cp rules.example.json rules.json

rules.json을 열고 다음을 입력하세요:

• 관심 목록 (매일 아침 스캔할 심볼)

• 바이어스 기준 (무엇이 강세/약세/중립인지 판단하는 기준)

• 리스크 규칙 (매 세션 전에 Claude가 확인하길 원하는 규칙)

3. CDP로 TradingView 실행

TradingView는 디버그 포트가 활성화된 상태로 실행되어야 합니다.

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

또는 설정 후 MCP 도구 사용: "tv_launch를 사용하여 디버그 모드로 TradingView를 시작해"

4. Claude Code에 추가

~/.claude/.mcp.json에 추가 (기존 서버와 병합):

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/tradingview-mcp-jackson/src/server.js"]
    }
  }
}

YOUR_USERNAME을 실제 사용자 이름으로 바꾸세요. Mac에서 확인: echo $USER

5. 확인

Claude Code를 재시작한 후 물어보세요: "tv_health_check를 사용하여 TradingView가 연결되었는지 확인해"

6. 첫 모닝 브리프 실행

Claude에게 물어보세요: "morning_brief를 실행하고 내 세션 바이어스를 알려줘"

또는 터미널에서:

npm link  # install tv CLI globally (one time)
tv brief

모닝 브리프 워크플로우

이것은 이 도구를 단순한 툴킷에서 일상 습관으로 바꿔주는 기능입니다.

매 세션 전:

1. TradingView가 열려 있음 (디버그 포트로 실행)

2. 터미널에서 tv brief 실행 (또는 Claude에게 "morning_brief 실행" 요청)

3. Claude가 관심 목록의 모든 심볼을 스캔하고, 지표 값을 읽고, 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

Overall: Cautious session. BTC leading bearish, SOL the exception — watch for divergence.

4. 저장: "이 브리프 저장해" (session_save 사용)

5. 다음 날 아침 비교: "어제 세션 가져와" (session_get 사용)

이 도구가 하는 일

• 모닝 브리프 — 관심 목록 스캔, 지표 읽기, 규칙 적용, 세션 바이어스 출력

• Pine Script 개발 — AI로 스크립트 작성, 주입, 컴파일, 디버그

• 차트 탐색 — 심볼, 타임프레임 변경, 날짜로 확대/축소, 지표 추가/제거

• 시각적 분석 — 지표 값, 가격 레벨, 커스텀 지표의 그려진 레벨 읽기

• 차트 그리기 — 추세선, 수평 레벨, 사각형, 텍스트

• 알림 관리 — 가격 알림 생성, 목록, 삭제

• 리플레이 연습 — 과거 바 진행, P&L 추적으로 진입/청산 연습

• 스크린샷 — 차트 상태 캡처

• 멀티 패널 레이아웃 — 패널별 다른 심볼로 2x2, 3x1 그리드

• 데이터 스트리밍 — 모니터링 스크립트용 라이브 차트의 JSONL 출력

• CLI 접근 — 모든 도구는 tv 명령으로도 사용 가능, 파이프 친화적 JSON 출력

Claude가 어떤 도구를 사용할지 아는 방법

Claude는 이 프로젝트에서 작업할 때 CLAUDE.md를 자동으로 읽습니다. 전체 의사 결정 트리가 포함되어 있습니다.

도구 참조 (81개 MCP 도구)

모닝 브리프 (이 포크의 새로운 기능)

차트 읽기

커스텀 지표 데이터 (Pine 드로잉)

표시된 모든 Pine 지표에서 line.new(), label.new(), table.new(), box.new() 출력 읽기.

항상 study_filter 를 사용하여 특정 지표를 대상으로 지정: study_filter: "MyIndicator".

차트 제어

Pine Script 개발

리플레이 모드

멀티 패널, 알림, 드로잉, UI

CLI 명령어

tv brief                           # run morning brief
tv session get                     # get today's saved brief
tv session save --brief "..."      # save a brief

tv status                          # check connection
tv quote                           # current price
tv symbol BTCUSD                   # change symbol
tv ohlcv --summary                 # price summary
tv screenshot -r chart             # capture chart
tv pine compile                    # compile Pine Script
tv pane layout 2x2                 # 4-chart grid
tv stream quote | jq '.close'      # monitor price ticks

전체 명령어 목록: tv --help

문제 해결

아키텍처

Claude Code  ←→  MCP Server (stdio)  ←→  CDP (port 9222)  ←→  TradingView Desktop (Electron)

• 원래 도구 78개 + 모닝 브리프 도구 3개 = 총 81개 MCP 도구

• 전송: stdio + CLI(tv 명령어)를 통한 MCP

• 연결: localhost:9222의 Chrome DevTools Protocol

• 외부 네트워크 호출 없음 — 모든 것이 로컬에서 실행됨

• 추가 의존성 없음 — 원본 외

크레딧

이 포크는 @tradesdontlie의 tradingview-mcp를 기반으로 합니다. 원본 도구가 기반입니다 — 저장소에 스타를 남겨주세요.

고지 사항

이 프로젝트는 개인적, 교육적, 연구 목적으로만 제공됩니다.

이 도구는 모든 Chromium 기반 애플리케이션에 내장된 표준 디버깅 인터페이스인 Chrome DevTools Protocol(CDP)을 사용합니다. TradingView의 독점 프로토콜을 리버스 엔지니어링하거나, TradingView 서버에 연결하거나, 접근 제어를 우회하지 않습니다. 디버그 포트는 표준 Chromium 명령줄 플래그를 통해 사용자가 명시적으로 활성화해야 합니다.

이 소프트웨어를 사용함으로써 다음 사항에 동의하게 됩니다:

1. 귀하의 사용이 TradingView 이용약관 및 모든 관련 법률을 준수하는지 확인할 책임은 전적으로 귀하에게 있습니다.

2. 이 도구는 언제든지 변경될 수 있는 문서화되지 않은 TradingView 내부 API에 접근합니다.

3. 이 도구는 TradingView의 시장 데이터를 재배포, 재판매 또는 상업적으로 이용하는 데 사용되어서는 안 됩니다.

4. 작성자는 계정 정지, 일시 중지 또는 기타 결과에 대해 책임을 지지 않습니다.

사용에 따른 위험은 본인이 감수하세요.

라이선스

MIT — LICENSE 참조. 소스 코드에만 적용되며 TradingView의 소프트웨어, 데이터 또는 상표에는 적용되지 않습니다.