tradingview-mcp-review

검토 전용 파생 버전으로, tradesdontlie/tradingview-mcp에서 파생되었습니다. TradingView Desktop 차트를 Chrome DevTools Protocol(127.0.0.1:9222)을 통해 라이브로 확인하며 거래 기록을 검토할 수 있는 9개의 MCP 도구를 제공합니다.

이는 범용 브리지가 아닙니다. 업스트림 프로젝트는 Pine Script 편집, 알림, 관심 목록, 리플레이 트레이딩, UI 자동화, 임의 JS 평가, 프로세스 제어, 자체 업데이트 등 84개의 도구를 제공합니다. 본 빌드는 코드 수준에서 이 모든 기능을 제거하고 거래 기록 검토에 필요한 기능만 유지합니다: 거래가 발생한 차트로 이동, 가격 컨텍스트 읽기, 진입/청산 레벨 표시, 스크린샷 촬영.

TradingView Inc. 또는 Anthropic, PBC와 제휴, 보증, 관련이 없습니다. TradingView와의 프로그래밍 방식 상호작용은 TradingView 이용약관과 상충될 수 있습니다 — 사용자는 본인의 사용이 이를 준수하는지 확인할 책임이 전적으로 있습니다. 업스트림 프로젝트의 면책 조항이 여기에도 완전히 적용됩니다.

보안 경계 (설계상)

• 로컬호스트 전용. CDP 엔드포인트는 127.0.0.1:9222로 고정되어 있으며 환경 변수나 설정으로 재정의할 수 없습니다.

• 고권한 프리미티브 없음. 자체 업데이트, 프로세스 실행/종료, 임의 JS 평가, Pine 편집기, 알림/관심 목록/리플레이/주문 기능이 없습니다. 단순히 등록 해제된 것이 아니라 소스 수준에서 제거(파일 삭제)되었습니다.

• 임의 입력 없음. 호출자가 제어하는 파일 경로가 없습니다(스크린샷은 프로그램 생성 이름으로 generated/screenshots/에 저장). 시간 프레임은 열거형이며, 심볼은 길이 제한이 있습니다.

• 레이아웃 변경은 잠재적으로 영구적일 수 있음. 심볼/시간 프레임을 변경하면 저장된 TradingView 레이아웃이 더러워질 수 있습니다(레이아웃 자동 저장이 켜져 있으면 영구 저장됨). 전용 임시 레이아웃에서 작업하세요.

• 로컬 전용 상태 확인. 업스트림 GitHub 업데이트 확인은 제거되었습니다. 서버는 로컬 디버그 포트 외에는 네트워크 요청을 전혀 보내지 않습니다.

• CI에서 강제 적용. tests/tool_surface.test.js는 도구 목록이 정확히 7개의 허용 목록과 일치하는지, 그리고 명명된 업스트림 기능이 없는지 확인하므로, 업스트림 병합이 조용히 이를 다시 도입할 수 없습니다.

Related MCP server: TradingView MCP Jackson

7가지 도구

차트 주석(draw_shape / draw_clear)은 이 릴리스에 포함되지 않습니다. 주석을 안전하게 제거하려면 이 세션이 생성한 도형임을 증명해야 하는데, TradingView 레이아웃 전환 시 소유권을 신뢰할 수 없게 됩니다. 증명할 수 없는 clear는 사용자의 직접 그린 도형까지 삭제합니다. 해당 기능은 증명 가능한 계약과 함께 나중에 제공될 예정이며, 주의사항과 함께 제공되지 않습니다.

의도된 아키텍처: 거래 기록이 진실의 원천 → 분석은 로컬에서 수행 → TradingView 디버그 인스턴스는 시각적 컨텍스트만 제공

설정

요구 사항: TradingView Desktop (구독 필요), Node.js 18+.

git clone https://github.com/F-e-u-e-r/tradingview-mcp-review.git
cd tradingview-mcp-review
npm ci --ignore-scripts

직접 TradingView Desktop을 디버그 포트로 실행하세요 (서버가 의도적으로 대신 실행하지 않습니다):

./scripts/launch_tv_debug_mac.sh          # macOS
# or manually, any platform:
/path/to/TradingView --remote-debugging-port=9222

디버그 포트는 검토 세션에서만 활성화하세요 — 켜져 있는 동안에는 모든 로컬 프로세스가 해당 TradingView 인스턴스를 제어할 수 있습니다. 사용이 끝나면 정상적으로 종료하고 다시 실행하세요. Chrome 탭의 원격 디버깅이 아닌 TradingView Desktop을 사용하세요 (Chrome 탭은 전체 브라우저 프로필을 노출시킵니다).

MCP 클라이언트 설정(예: 프로젝트 .mcp.json)에 추가:

{
  "mcpServers": {
    "tradingview-review": {
      "command": "node",
      "args": ["/path/to/tradingview-mcp-review/src/server.js"]
    }
  }
}

게이트

npm run lint   # eslint no-undef guard (catches unfinished refactors)
npm test       # tool-surface allowlist/denylist gate + sanitization + unit tests (all offline)

출처

보안 검증된 커밋 시점의 업스트림 트리에서 포크되었습니다. 이후의 모든 변경 사항은 UPSTREAM.md에 열거되어 있으며, 이 파일은 업스트림 업데이트를 가져올 때 재검증 절차도 정의합니다. 라이선스: MIT (LICENSE 참조, 저작권은 업스트림 작성자에게 있음).