massive-mcp

Massive.com REST Stocks API를 Claude Desktop 및 Claude Code에 노출하는 MCP(Model Context Protocol) 서버입니다.

FastMCP와 httpx(비동기)를 사용하여 구축되었으며, Stdio 전송을 사용합니다.

지원 범위

응답 크기를 작게 유지하기 위해 기본값이 설정되어 있으며(낮은 limit, 200개 항목에서 잘림 및 _truncated_note 표시), 모든 페이지네이션 도구는 cursor를 허용하고 데이터가 더 있을 경우 next_cursor를 반환합니다.

설치

# Recommended: uv
uv tool install --from . massive-mcp
# or pipx
pipx install .

개발용:

uv sync --extra dev
uv run pytest

구성

환경 변수를 통해 API 키를 설정하세요. 두 가지 인증 모드가 모두 지원됩니다. 먼저 bearer로 시작하고, Massive에서 401 오류가 발생하면 query로 전환하세요.

export MASSIVE_API_KEY=sk_live_...
export MASSIVE_AUTH_MODE=bearer   # or "query"

또는 .env.example을 .env로 복사하세요.

연결

Claude Desktop

claude_desktop_config.json을 편집하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": ["massive-mcp"],
      "env": {
        "MASSIVE_API_KEY": "sk_live_...",
        "MASSIVE_AUTH_MODE": "bearer"
      }
    }
  }
}

Claude Desktop을 재시작하세요.

Claude Code

claude mcp add massive --env MASSIVE_API_KEY=sk_live_... --env MASSIVE_AUTH_MODE=bearer -- uvx massive-mcp

로컬 개발

uv run massive-mcp

MCP Inspector를 사용하여 도구를 수동으로 테스트하세요:

npx @modelcontextprotocol/inspector uvx massive-mcp

사용 예시

연결이 완료되면 Claude에게 다음과 같이 질문해 보세요:

• "NVDA의 전일 종가는 얼마인가요?"

• "지난 12개월간의 AAPL 배당금을 가져와줘."

• "현재 가장 많이 상승한 상위 10개 종목을 보여줘."

• "어제 TSLA의 5분 단위 바 데이터를 가져와줘."

• "지난 30일간 SPY의 RSI를 알려줘."

보조 스킬

이 저장소에는 MCP 도구를 사용하여 전문적인 스윙/장기 거래 계획(진입, 손절매, 단계적 익절, 손익비, 포지션 규모 산정)을 생성하는 Claude 스킬인 **massive-trade-analysis**도 포함되어 있습니다. 설치 방법은 skills/를 참조하세요.

참고 사항 및 제한 사항

• REST만 지원합니다. WebSocket / FlatFiles는 지원하지 않습니다.

• 주식 자산 클래스만 지원합니다. 옵션/FX/암호화폐 엔드포인트는 v1 범위에서 제외됩니다.

• 일부 엔드포인트(/vX/...)는 Massive에서 베타 버전으로 관리되므로 경로가 변경될 수 있습니다.

• 429 응답은 Retry-After를 준수하여 자동으로 재시도됩니다. 5xx 응답은 지수 백오프(최대 3회 시도)로 재시도됩니다.

• API 키는 절대 로그에 기록되지 않습니다. 오류 발생 시 노출된 URL에서 apiKey가 제거됩니다.

라이선스

MIT