tradingview-mcp

AI 에이전트에 TradingView 중심의 트레이딩 툴킷을 제공하는 MCP 서버: 스크리너 쿼리, 과거 FX 데이터, 그리고 마일스톤이 완료됨에 따라 SMC/ICT 패턴 스캔, 마크업이 포함된 차트 렌더링, 백테스팅, Pine 도구, 그리고 함께 제공되는 Agent Skills 번들.

TradingView, Inc.와 제휴 관계가 아닙니다. "TradingView", "Pine Script" 및 "Lightweight Charts"는 TradingView, Inc.의 상표입니다.

상태

M0-M5 완료: 서버는 public/data 기본값으로 부팅됩니다. SMC 스캔, 차트 렌더링, 백테스팅, FX Replay 저널 동기화, TradingView 계정 데이터(session), Pine 컴파일, Desktop CDP(스크린샷, 탐색, 라이브 차트에 그리기, 사용자 자신의 인디케이터 읽기 — 플롯 값 및 Pine으로 그린 FVG/OB 영역), 그리고 선언적 전략을 위한 옵트인 툴셋. tv CLI(모든 도구 = JSON을 출력하는 하위 명령), 10개의 동반 스킬, 검증된 Claude Code 플러그인 매니페스트를 제공합니다. 미해결 항목: M1의 신뢰 게이트는 여전히 소유자의 실제 수작업 라벨링된 SMC 설정을 기다리고 있습니다. 웹훅 수신기, MCP Apps, 샌드박스 Python 전략 탈출구는 연기되었습니다. 로드맵: docs/PLAN.md.

Related MCP server: TradingView MCP Bridge

Claude Code 플러그인으로 설치

/plugin marketplace add Miha21222/tradingview-mcp
/plugin install tradingview-mcp@tradingview-mcp-marketplace

설치 시 선택적 자격 증명(OANDA 연습 키, TradingView sessionid)과 운영자 설정(TV_TOOLSETS, TV_READ_ONLY, ...)을 묻습니다. 기본 public,data 표면에는 아무것도 필요하지 않으며, TradingView 계정 없이도 작동합니다. PATH에 uv가 필요합니다.

빠른 시작

uv sync
uv run python -m tvmcp --check    # list registered tools
uv run python -m tvmcp            # run on stdio
uv run tv --check                 # CLI: list tools
uv run tv tv_data_get_bars '{"symbol":"EURUSD","count":10}'   # CLI: call any tool -> JSON

옵트인 chart 툴셋은 헤드리스 Chromium을 통해 렌더링합니다. 활성화하려면 uv run playwright install chromium을 한 번 실행하세요. 옵트인 툴셋은 TV_TOOLSETS=default,scan,chart,backtest,journal로 활성화합니다.

Claude Code: 프로젝트를 신뢰하면 저장소의 .mcp.json이 서버를 자동으로 등록합니다.

구성 (환경 변수)

uv run tv tv_setup_doctor를 실행하여 모든 사전 요구 사항을 확인하세요 — 각 실패한 검사는 정확한 수정 명령을 반환합니다.

TradingView 서비스 약관

기본 툴셋은 TradingView 계정을 사용하지 않습니다: public 툴셋은 TradingView의 공개 스크리너 엔드포인트와 통신하고, 시장 데이터는 Dukascopy/OANDA에서 제공됩니다. TradingView의 ToS는 자동 데이터 수집 및 데이터의 비표시 사용을 금지합니다. 선택적 session 및 desktop 툴셋(기본적으로 꺼짐)은 사용자 자신의 TradingView 계정/데스크톱 앱과 사용자 자신의 책임 하에 상호 작용합니다 — 이를 활성화하는 것은 사용자의 명시적 선택이며 TradingView의 ToS를 위반하고 계정 제한의 위험이 있을 수 있습니다. 둘 다 첫 사용 시 stderr에 ToS/밴 경고를 출력합니다. 이 프로젝트는 개인 연구/교육용입니다.

라이선스

MIT — LICENSE 참조. TradingView, Inc.와 제휴 관계가 아닙니다. 보호/초대 전용 Pine 스크립트는 작성자의 자산으로 유지됩니다 — 연구 도구는 사용자 자신의 차트에 있는 인디케이터의 렌더링된 출력만 읽으며, 소스 코드는 절대 읽지 않습니다.