TradingView MCP

시장 데이터, 결정적 기술적 분석, 차트 렌더링, 그리고 선택적인 TradingView Supercharts 브라우저 워크플로우를 위한 로컬 우선 Model Context Protocol 서버 및 루프백 REST API입니다.

이 서버는 stdio를 통해 실행되며, 도구가 필요할 때만 로컬 뷰어와 Playwright 브라우저를 시작합니다. 고수준 히스토리 및 분석 도구는 기본적으로 관리형 브라우저를 자동으로 닫습니다.

[!IMPORTANT] 이 프로젝트는 독립적인 오픈소스 프로젝트입니다. TradingView와 제휴, 후원, 또는 보증 관계가 아닙니다. TradingView 및 Lightweight Charts는 TradingView, Inc.의 상표입니다. 사용자는 TradingView의 이용약관, 계정 권한, 거래소 자격, 그리고 적용 가능한 데이터 라이선스를 준수할 책임이 있습니다.

기능

• 시장 탐색, 시세, OHLCV, 분석, 차트 상태를 위한 MCP 도구

• 정확한 심볼, 인터벌, 날짜 범위에 대한 원클릭 공식 TradingView 스크린샷

• OHLCV, 갭, 변동, 거래량, 내보낸 지표 필드, 롤링 성과, 기술적 분석을 포함한 원클릭 과거 날짜 컨텍스트

• 결정적 SMA, EMA, RSI, MACD, 볼린저 밴드, ATR, 추세, 시그널, 지지/저항 계산

• PNG 캡처가 가능한 로컬 Lightweight Charts 뷰어

• CSV, 인라인 OHLCV, 데모 데이터, 선택적 구성된 업스트림 지원

• 원자적 지표, 레벨, 커스텀 시리즈, 가격 영역, 마커 오버레이

• 기본적으로 간결한 MCP 결과를 제공하여 대용량 OHLCV 배열이 모델 컨텍스트를 불필요하게 소모하지 않음

• 계정 인증 TradingView Supercharts 탐색, CSV 내보내기, 지표, 스크린샷을 위한 옵트인 Playwright 워크플로우

• 루프백 전용 HTTP 바인딩, 경로 격리, 입력 검증, 자격 증명 필터링, 실패 시 차단되는 브라우저 검사

Related MCP server: TradingView MCP Jackson

아키텍처

MCP client -- stdio --+-- deterministic analysis and chart state
                      +-- on-demand local viewer / PNG capture
                      +-- optional on-demand TradingView browser

REST client -- loopback HTTP -- local viewer and compatible JSON endpoints

로컬 뷰어는 결정적 렌더링 표면입니다. 독점 TradingView 차트 기능의 클론이 아닙니다. 호환성 경계를 참조하세요.

요구 사항

• Node.js 22 이상

• npm

• 스크린샷 또는 브라우저 도구를 사용할 때 Playwright를 통해 설치된 Chromium

소스에서 설치

git clone https://github.com/moeuu/tradingview-mcp.git
cd tradingview-mcp
npm ci
npx playwright install chromium
npm run build

Linux CI 또는 Chromium 시스템 종속성이 없는 머신의 경우:

npx playwright install --with-deps chromium

MCP 클라이언트 연결

TradingView MCP는 클라이언트 독립적입니다. 표준 MCP stdio 전송을 사용하며 클라이언트별 API를 호출하지 않습니다. 로컬 프로세스를 실행할 수 있는 모든 MCP 클라이언트는 다음을 사용할 수 있습니다:

node /absolute/path/to/tradingview-mcp/dist/mcp.js

많은 데스크톱 및 에디터 클라이언트는 이 공통 구성 형태를 사용합니다:

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["/absolute/path/to/tradingview-mcp/dist/mcp.js"],
      "env": {
        "MARKET_CHART_PORT": "0",
        "MARKET_CHART_DATA_ROOT": "/absolute/path/to/tradingview-mcp/data"
      }
    }
  }
}

필요한 경우 외부 구성 키를 클라이언트에 맞게 조정하세요. 명령, 인수, 환경, MCP 프로토콜은 동일하게 유지됩니다. 구성을 변경한 후 클라이언트를 다시 시작하세요. MARKET_CHART_PORT=0은 임시 뷰어 포트를 선택하고 영구적으로 수신 대기하는 서비스를 피합니다.

전송 동작, 수명 주기, 문제 해결에 대해서는 MCP 클라이언트 설정 및 호환성을 참조하세요.

권장 MCP 워크플로우

1. 공급자 가용성이 불확실할 때 market_get_capabilities를 호출하세요.

2. 특정 날짜의 심볼에 대한 포괄적인 정보를 위해 tradingview_get_day를 사용하세요.

3. 정확한 달력 날짜를 포함하는 공식 Supercharts PNG를 위해 tradingview_capture_period를 사용하세요.

4. 원클릭 최근 히스토리와 결정적 분석을 위해 tradingview_analyze_symbol을 사용하세요.

5. 최근 히스토리만 필요할 때 tradingview_get_history를 사용하세요.

6. 로컬/사용자 제공 데이터를 위해 chart_import_csv 또는 chart_set_data를 사용하세요.

7. 로컬 분석 및 시각화를 위해 chart_analyze, chart_apply_overlays, chart_snapshot을 사용하세요.

예시 호출:

{
  "name": "tradingview_capture_period",
  "arguments": {
    "symbol": "NASDAQ:AAPL",
    "interval": "D",
    "from": "2024-01-02",
    "to": "2024-03-28"
  }
}

{
  "name": "tradingview_get_day",
  "arguments": {
    "symbol": "NASDAQ:AAPL",
    "date": "2024-01-03",
    "interval": "D",
    "timezone": "America/New_York"
  }
}

tradingview_get_day는 주말, 공휴일, 사용 불가 날짜에 대해 가까운 세션을 조용히 대체하지 않고 명시적 no_session_bar 상태를 반환합니다. 일치하는 날짜에는 세션 OHLCV, 로드된 경우 이전 및 다음 바, 이전 종가 및 시가 갭 변동, 장중 범위, 롤링 5/20/50/200 기간 성과, 결정적 지표 및 시그널, 그리고 공식 TradingView 차트 내보내기에 존재하는 모든 추가 지표 열을 반환합니다. 해당 날짜에 할당된 모든 내보낸 바를 수신하려면 장중 interval과 includeBars:true를 설정하세요.

고수준 TradingView 도구는 기본적으로 브라우저를 닫습니다. MCP 응답에 원시 바가 필요한 경우에만 includeBars: true를 설정하고, 즉시 후속 브라우저 도구를 사용할 때만 keepBrowserOpen: true를 설정하세요.

서버는 고수준 및 세분화된 도구를 모두 제공합니다. enabled_tools 허용 목록을 지원하는 클라이언트는 특정 워크플로우에 필요한 도구만 노출할 수 있습니다.

선택적 TradingView 브라우저 워크플로우

브라우저 자동화는 기본적으로 비활성화되어 있습니다. 쿠키 내보내기는 필수 세션 쿠키만 포함할 수 있으므로 선호되는 인증 소스입니다. MCP 인수, 저장소 파일, 클라이언트 구성 또는 프롬프트에 자격 증명 값을 붙여넣지 마세요.

chmod 600 /absolute/path/to/tradingview-cookies.txt
export TRADINGVIEW_BROWSER_ENABLED=true
export TRADINGVIEW_BROWSER_BASE_URL=https://www.tradingview.com
export TRADINGVIEW_BROWSER_COOKIE_FILE=/absolute/path/to/tradingview-cookies.txt
export TRADINGVIEW_BROWSER_AUTH_COOKIE_NAMES=sessionid,sessionid_sign,device_t
export TRADINGVIEW_BROWSER_HEADLESS=true
export TRADINGVIEW_BROWSER_TIMEOUT_MS=120000

인증 파일은 저장소 외부에 있어야 하며, 1 MiB 미만이어야 하고, POSIX 시스템에서 소유자 전용 권한을 가져야 합니다. 기본 정책은 TradingView 도메인에서 sessionid, sessionid_sign, device_t만 가져옵니다. 로컬 스토리지는 기본적으로 가져오지 않습니다. 쿠키 값, 스토리지 값, 인증 파일 경로는 MCP 도구 인수로 허용되거나 MCP/REST 응답으로 반환되지 않습니다.

쿠키 내보내기를 사용할 수 없을 때 Playwright storage-state 파일을 TRADINGVIEW_BROWSER_AUTH_STATE와 함께 사용할 수 있습니다. 동일한 쿠키 허용 목록이 적용됩니다. 검증된 워크플로우가 특정 로컬 스토리지 키를 요구하는 경우에만 TRADINGVIEW_BROWSER_AUTH_STORAGE_KEYS를 설정하세요. 기본값은 비어 있습니다.

Supercharts UI 가용성, 선택자, 내보내기, 계정 플랜, 거래소 자격, 지연/실시간 상태는 TradingView가 제어하며 이 프로젝트와 독립적으로 변경될 수 있습니다. 자동화는 계정 업그레이드나 구매를 시도하지 않습니다.

자세한 내용과 제한 사항은 TradingView 브라우저 워크플로우를 참조하세요.

독립형 REST API 및 뷰어

REST API는 선택 사항이며 일반적인 MCP 사용에는 실행할 필요가 없습니다.

npm run serve

기본적으로 127.0.0.1:4317에 바인딩됩니다:

curl http://127.0.0.1:4317/api/health
curl 'http://127.0.0.1:4317/api/price/DEMO:MARKET?timeframe=60&range=20'

유료/구성된 업스트림을 활성화하거나 민감한 로컬 차트 데이터를 다른 로컬 프로세스에 노출하기 전에 베어러 토큰을 설정하세요:

export MARKET_CHART_API_TOKEN='replace-with-a-long-random-value'
npm run serve

HTTP 바인딩은 루프백 주소로 제한됩니다. REST API 참조를 참조하세요.

구성

.env.example을 참조용으로 복사하되, 실제 값은 셸, 프로세스 관리자 또는 비밀 저장소에서 로드하세요. 애플리케이션은 .env 파일을 자동으로 읽지 않습니다.

로컬 CSV 형식

CSV 가져오기는 MARKET_CHART_DATA_ROOT 내에서 해석되어야 하며, 오름차순 타임스탬프를 포함하고, 구성된 한도 내에 있어야 합니다.

time,open,high,low,close,volume
2026-01-02T00:00:00Z,100,104,99,103,1200000
2026-01-03T00:00:00Z,103,106,101,105,1350000

timestamp 또는 date가 time을 대체할 수 있습니다. Unix 초 및 밀리초도 허용됩니다.

보안 모델

• 유휴 stdio MCP 프로세스는 네트워크 리스너를 생성하지 않습니다.

• 로컬 HTTP 라우트는 루프백에만 바인딩하고 Host 헤더를 검증합니다.

• 가져온 파일은 실제 경로 격리를 사용하고 심볼릭 링크 탐색을 거부합니다.

• 브라우저 인증은 소유자 전용 외부 파일 하나에서 읽고 도메인, 쿠키 이름, 만료, 크기, 선택적 로컬 스토리지 키 허용 목록으로 필터링됩니다.

• MCP 및 REST 요청 스키마는 쿠키, 토큰, 스토리지 상태, 인증 파일 경로를 허용하지 않습니다.

• 브라우저 작업은 상태 저장 UI 작업을 직렬화하고 자격 증명 유사 도구 입력을 거부합니다.

• 생성된 브라우저 아티팩트, 자격 증명, .env 파일, 추적, 로컬 시장 데이터는 Git에서 무시됩니다.

• 결과는 분석적 관찰일 뿐, 투자 조언이나 미래 성과 보장이 아닙니다.

취약점은 SECURITY.md에 따라 보고해 주세요.

개발

npm ci
npx playwright install chromium
npm run check

npm run check는 공개 릴리스 안전 검사, 저장소 전체 영어 전용 텍스트 검증, 엄격한 TypeScript 검사, 전체 Vitest 스위트, 프로덕션 빌드를 실행합니다.

기여는 환영합니다. CONTRIBUTING.md를 참조하세요. 참여함으로써 CODE_OF_CONDUCT.md를 따르는 데 동의하는 것입니다.

라이선스 및 귀속

프로젝트 소스는 MIT 라이선스로 제공됩니다. 번들된 뷰어는 Apache-2.0에 따라 TradingView Lightweight Charts를 사용합니다. 필요한 고지는 NOTICE, THIRD_PARTY_LICENSES.md, licenses/Apache-2.0.txt에 있습니다.