wshobson/maverick-mcp

어떤 프로젝트인가요?

핵심 기능

• 01API 키 없이 Yahoo Finance에서 시세, 과거 OHLCV 가격 데이터, 펀더멘털을 가져옵니다.
• 02RSI, MACD와 관측된 지지선 및 저항선을 계산합니다.
• 03포트폴리오 보유 내역, 손익(P&L), 관심 종목 목록과 로컬 매매 일지를 관리합니다.
• 04불러온 종목을 대상으로 강세, 약세, 수급 스크리닝을 실행합니다.
• 05전략 템플릿과 ML 모델을 포함한 선택적 백테스트 도구를 제공합니다.
• 06설정된 LLM을 통해 출처를 인용하는 선택적 웹 리서치를 지원합니다.

활용 사례

• AI 어시스턴트에게 종목의 기술적 지표와 최근 가격 범위를 요약하도록 요청합니다.
• 보유 자산을 로컬에 기록하고 거래 전에 위험 노출을 점검합니다.
• Python 백테스트로 과거 데이터를 활용해 매매 아이디어를 검증합니다.
• 비공개 로컬 매매 일지에 과거 거래를 기록하고 검토합니다.

빠른 시작

1. 1

   리포지토리를 클론합니다

   git clone https://github.com/wshobson/maverick-mcp.git
2. 2

   프로젝트 폴더로 이동합니다

   cd maverick-mcp
3. 3

   핵심 종속성을 설치합니다

   uv sync
4. 4

   MCP 클라이언트용 서버를 시작합니다(경로를 체크아웃한 디렉터리의 절대 경로로 바꾸세요)

   uv run --directory /absolute/path/to/maverick-mcp maverick-mcp --transport stdio

사용 전 알아둘 점

• !Streamable HTTP 서버에는 인증 기능이 없으므로 접근 제어를 추가하지 않는 한 로컬에서만 사용하세요.
• !시장 데이터는 Yahoo Finance에서 제공하며 지연되거나 불완전하거나 잘못되었을 수 있습니다. 이 프로젝트는 금융 조언을 제공하지 않습니다.
• !Python 3.12 이상과 uv 도구가 필요하며, 선택적 리서치 기능을 사용하면 모델 및 검색 제공업체 이용 요금이 발생할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

maverick-mcp은(는) 무엇인가요?

Yahoo Finance 기반 주가 조회, 기술적 분석, 포트폴리오 추적과 선택적 Python 백테스트를 AI 어시스턴트에 제공하는 로컬 MCP 서버입니다. MaverickMCP는 주식 시장 분석을 위한 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Cursor, VS Code 같은 AI 어시스턴트가 도구를 호출해 yfinance를 통해 Yahoo Finance에서 가격과 펀더멘털 데이터를 가져오고, RSI와 MACD 같은 지표를 계산하며, 관측된 지지선과 저항선을 확인할 수 있습니다. 핵심 도구는 API 키가 필요 없으며, 기본적으로 로컬 SQLite 데이터베이스에 포트폴리오, 관심 종목 목록, 매매 일지를 저장합니다.

maverick-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

maverick-mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

maverick-mcp은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. maverick-mcp의 마지막 커밋은 2026년 11월 6일입니다.

maverick-mcp은(는) 어디에 사용할 수 있나요?

AI 어시스턴트에게 종목의 기술적 지표와 최근 가격 범위를 요약하도록 요청합니다. 보유 자산을 로컬에 기록하고 거래 전에 위험 노출을 점검합니다. Python 백테스트로 과거 데이터를 활용해 매매 아이디어를 검증합니다. 비공개 로컬 매매 일지에 과거 거래를 기록하고 검토합니다.

maverick-mcp는 어떻게 설치하나요?

리포지토리를 클론합니다: git clone https://github.com/wshobson/maverick-mcp.git 프로젝트 폴더로 이동합니다: cd maverick-mcp 핵심 종속성을 설치합니다: uv sync MCP 클라이언트용 서버를 시작합니다(경로를 체크아웃한 디렉터리의 절대 경로로 바꾸세요): uv run --directory /absolute/path/to/maverick-mcp maverick-mcp --transport stdio

maverick-mcp은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/wshobson/maverick-mcp