TL;DR

이 레포는 TradingView의 스캐너, 시세, 뉴스, Reddit 심리 지표를 Model Context Protocol(MCP) 규격으로 노출하는 TypeScript 기반 서버이다. 아키텍처는 MCP 라우터가 입력을 검증해 독립적인 서비스 계층으로 위임하며 스크리너 제공자는 retry, jitter, throttling과 캐시 통합을 수행하고 Redis를 옵션으로 지원한다. 내장 백테스트 엔진은 9개 전략과 Sharpe, Calmar, walk-forward 과적합 탐지 지표를 산출하며 결과는 MCP 페이로드로 반환된다. 이 소프트웨어는 공개 엔드포인트만 사용해 TradingView 계정 없이 동작하며 출력은 연구·교육 목적으로 한정되어 금융 자문으로 사용해서는 안 된다.

핵심 포인트

• MCP 네이티브 구현으로 36개의 툴과 stdio 트랜스포트를 제공하며 Claude Desktop, Cursor, Copilot 등 다양한 MCP 호스트와 즉시 연동된다. 이 점은 MCP 표준을 따르는 클라이언트 환경과의 상호운용성을 높여 별도 어댑터 개발 부담을 줄인다. README에 명시된 도구 수와 호환 호스트 목록이 이 호환성 근거가 된다.
• 서비스 계층 분리와 엄격한 TypeScript 설정(strict, noUnusedLocals, noUncheckedIndexedAccess)은 도메인 로직의 테스트 가능성과 코드 안전성을 높인다. MCP 라우터는 입력 유효성 검사만 수행하고 핵심 비즈니스 로직은 services 디렉터리에 위치한다. 이 구조는 도구 추가 시 MCP 레이어에 영향을 주지 않고 기능 확장이 가능하도록 설계되었다.
• 캐시 추상화는 Redis를 옵션으로 두어 분산 캐시가 가능할 때 확장성과 중복 호출 감소 효과를 얻고 Redis 장애 시 자동으로 인메모리 캐시로 폴백한다. 스크리너 제공자는 retry, jitter, throttling을 적용해 외부 API 레이트 리밋과 불안정성에 대응하도록 구현되어 있다. 이로 인해 프로덕션 환경에서의 복원력과 가용성이 개선된다.
• 내장 백테스트는 9개 전략과 Sharpe, Calmar, walk-forward 과적합 탐지 기능을 포함해 전략 검증을 자동화한다. 백테스트는 Yahoo Finance 데이터에 기반하여 비용을 시뮬레이션하고 결과를 정량 지표로 산출한다. 이 기능은 별도의 백테스트 파이프라인 없이 MCP 도구 내에서 신속한 전략 비교가 가능하도록 한다.