tradingview-mcp-chefy

실제로 백테스트를 수행하는 트레이더를 위한 토큰 효율적인 TradingView MCP입니다.

이 프로젝트는 전략 테스트를 위해 특별히 제작된 포크 버전입니다. 기존 TradingView MCP는 차트 읽기나 아침 워크플로우에는 잘 작동하지만, Pine 전략을 반복할 때 토큰을 과도하게 소모합니다. 모든 백테스트 읽기 작업마다 전체 거래 목록, 자산 곡선, 콘솔 출력을 컨텍스트에 덤프하기 때문입니다. 이 포크 버전은 데이터가 전송되기 전에 TradingView 런타임 내부에서 데이터를 집계하도록 읽기 방식을 재작성하여, 기본적으로 요약 정보를 반환하고 상세 정보는 필요할 때만 가져오도록 합니다.

크레딧

이 프로젝트는 다음 두 가지 선행 작업을 기반으로 합니다:

• tradesdontlie/tradingview-mcp — 원본 CDP 브리지 및 도구 인터페이스. 어려운 스크래핑 작업을 수행했습니다.

• LewisWJackson/tradingview-mcp-jackson — 아침 브리핑 워크플로우, 규칙 설정 및 v2.14+ 실행 수정 사항을 추가한 포크 버전입니다. 이 프로젝트는 해당 버전을 포크했습니다.

이 저장소들이 도움이 되었다면 별을 눌러주세요.

이 포크의 차이점

실질적 효과: 일반적인 백테스트 읽기 작업 시 데이터 크기가 약 50KB에서 약 200바이트로 줄어듭니다. 반복 작업이 많은 세션(20회 이상 실행)에서는 토큰 비용이 20달러에서 1달러로 줄어드는 차이를 만듭니다.

상태

사전 출시(Pre-release). 포크 설정이 완료되었습니다. 새로운 집계 도구들이 현재 작성 중입니다. v0.2가 출시되기 전까지는 이 저장소가 LewisWJackson/tradingview-mcp-jackson과 동일하게 동작하므로, 당장 안정성이 필요하다면 해당 버전을 사용하십시오.

로드맵:

• [x] 저장소 포크, 구조 설정

• [ ] 브라우저 내 집계 기능을 포함한 backtest_summary

• [ ] backtest_trades_paged 커서 페이지네이션

• [ ] backtest_equity_summary 다운샘플링

• [ ] pine_console_errors 필터링 도구

• [ ] 업스트림 대비 토큰 비용 벤치마크

• [ ] 논란 없는 수정 사항을 LewisWJackson 업스트림으로 PR

• [ ] v0.2 릴리스

빠른 시작

현재는 업스트림과 설정이 동일합니다. v0.2에서 새로운 도구가 추가되어도 설치 경로는 동일하게 유지되며, mcpServers 설정 이름만 변경될 수 있습니다.

사전 요구 사항

• TradingView 데스크톱 앱 (실시간/전략 데이터 사용을 위한 유료 구독 필요)

• Node.js 18+

• Claude Code (또는 모든 MCP 클라이언트)

• macOS, Windows 또는 Linux

설치

git clone https://github.com/Chefy3x/tradingview-mcp-chefy.git ~/tradingview-mcp-chefy
cd ~/tradingview-mcp-chefy
npm install

디버그 포트로 TradingView 실행

Mac:

./scripts/launch_tv_debug_mac.sh

Windows:

scripts\launch_tv_debug.bat

Linux:

./scripts/launch_tv_debug_linux.sh

Claude Code에 추가

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

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

YOUR_USERNAME을 실제 사용자 이름으로 바꾸십시오 (Mac/Linux에서 echo $USER로 확인).

확인

Claude Code를 재시작하고 다음을 입력하십시오: "Use tv_health_check to verify TradingView is connected."

아키텍처

Claude Code  ←→  MCP stdio  ←→  src/server.js  ←→  CDP :9222  ←→  TradingView Desktop (Electron)

• 연결: localhost:9222에서 Chrome DevTools Protocol 사용

• 집계: 백테스트 읽기 시, CDP를 통해 전송된 JS 표현식이 데이터를 반환하기 전에 TradingView 런타임 내부에서 축소 작업을 수행합니다. 동일한 네트워크 홉을 사용하면서 데이터 전송량은 약 200배 감소합니다.

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

• 추가 의존성 없음 — 업스트림에서 사용하는 것 외에 추가된 의존성 없음

기여

업스트림과 상호 협력:

• 기존 도구의 토큰 효율성 개선 → LewisWJackson 업스트림으로 PR을 보내 모두가 혜택을 볼 수 있도록 합니다.

• 새로운 backtest_* 도구군 → 이 포크에서 유지합니다 (MCP 사용 방식에 대한 사고 모델을 변경하기 때문).

공유 코드 경로에서 버그를 발견하면 여기에 이슈를 열어주시면 처리하겠습니다.

면책 조항

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

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

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

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

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

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

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

사용에 따른 위험은 전적으로 사용자 본인에게 있습니다.

라이선스

MIT — LICENSE를 참조하십시오. 업스트림에서 상속되었습니다. 소스 코드에만 적용되며, TradingView의 소프트웨어, 데이터 또는 상표에는 적용되지 않습니다.