wshobson/maverick-mcp

Claude 데스크톱에서 전문가급 주식 분석과 포트폴리오 최적화를 하는 로컬 MCP 서버

설치형 도구맘대로 써도 됨 · MIT투자·금융난이도
596+0이번 주1435Python
데모·홈페이지 열기sethhobson.com
중간맛 분석

스택: Python 3.12+, FastMCP 2.0, TA-Lib, VectorBT, SQLAlchemy, Redis(선택). 난이도: 중간(TA-Lib 설치가 OS마다 다름, 그 외는 간단). 바로 쓸 수 있는가: 네, uv syncmake dev → Claude 설정 파일 수정하면 즉시 사용. 데모: Tiingo(무료) 만 있으면 작동, 옵션으로 OpenRouter/Exa/FRED 통합 가능. 39개 이상의 금융 분석 도구 제공, 포트폴리오 추적 기능 포함.

이런 레포예요

이럴 때 쓰면 좋아요

  • 개인 투자자가 Claude 안에서 실시간 주식 기술 분석과 포트폴리오 추적
  • 트레이더가 자신의 전략을 VectorBT로 백테스트하고 결과를 claude에서 해석
  • 포트폴리오 매니저가 상관관계 분석과 최적화를 자연어 질문으로 수행

핵심 기능

39개 이상의 금융 분석 도구(기술 지표, 스크리닝, 포트폴리오 최적화)520개 S&P 500 주식 사전 로드 및 스크리닝 추천VectorBT 기반 백테스팅 및 15개 이상 내장 전략

대안 대비 차별점

Claude Desktop과 직접 MCP 통합되어 API/UI 없이 대화형으로 금융 분석이 가능하며, 로컬 포트폴리오 추적과 함께 빠른 개발 경험(hot reload, 한 줄 시작)을 제공합니다.

준비물
  • Python 3.12+
  • TA-Lib (기술 분석용)
  • uv 또는 pip
  • Tiingo API 키 (무료)
바로 시작하기
  1. TA-Lib 설치
brew install ta-lib
  1. uv 설치 (선택사항이지만 권장)
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 레포 클론 및 의존성 설치
git clone https://github.com/wshobson/maverick-mcp.git
cd maverick-mcp
uv sync
  1. 환경 설정 (.env 복사 및 Tiingo API 키 추가)
cp .env.example .env
# .env 파일을 열어 TIINGO_API_KEY 입력 (무료: tiingo.com)
  1. 서버 시작
make dev
  1. Claude Desktop 설정 파일 수정 (~/.config/Claude/claude_desktop_config.json macOS의 경우 ~/Library/Application Support/Claude/claude_desktop_config.json)
{
  "mcpServers": {
    "maverick-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "maverick_mcp.api.server", "--transport", "stdio"],
      "cwd": "/path/to/maverick-mcp"
    }
  }
}

Claude Desktop 재시작 후 사용 가능.

별 추이 · 7일
596+0 / 7일
활용성 · 따라 만들기 좋은가
베스트 샘플샘플 점수 80/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2025년 생성

AI가 README 기반으로 요약했습니다 · 원문 보기