QuantData MCP 서버

본 서버는 비공식 MCP 서버이며, 저는 QuantData와 어떠한 방식으로도 제휴되어 있지 않습니다.

AI 에이전트(Claude Code, Claude Desktop 등)가 QuantData의 실시간 및 과거 옵션 시장 데이터에 접근할 수 있게 해주는 MCP 서버입니다.

📖 처음이신가요? 단계별 가이드는 시작하기 가이드를 참조하세요.

옵션 거래가 가능한 모든 티커를 지원합니다 — SPX, SPY, QQQ, AAPL, TSLA 등. 0DTE뿐만 아니라 모든 옵션을 지원합니다.

제공 데이터: GEX/DEX/CEX/VEX 익스포저 월, 익스포저 기간 구조, 순 드리프트, 맥스 페인, IV 랭크, 거래 측 통계, 미결제 약정, 순 흐름, 통합 주문 흐름, 계약 OHLCV 및 계약 통계.

문서: 단계별 가이드는 GETTING_STARTED.md를 참조하세요.

Related MCP server: traders-edge-mcp

빠른 시작

1. 설치

**Python 3.11+**가 설치되어 있어야 합니다. python3 --version으로 확인하세요.

• Mac: brew install python (또는 python.org에서 다운로드)

• Windows: python.org에서 다운로드 (설치 시 "Add to PATH" 체크)

PyPI에서 설치:

# With pip
pip install quantdata-mcp

# With uv (faster)
uv pip install quantdata-mcp

# Or install as a global tool with uv
uv tool install quantdata-mcp

uv가 없으신가요? curl -LsSf https://astral.sh/uv/install.sh | sh (Mac/Linux) 또는 irm https://astral.sh/uv/install.ps1 | iex (Windows)로 설치하세요. pip보다 빠른 대안입니다.

최신 기능을 원하시나요? GitHub에서 설치하세요: pip install git+https://github.com/zzulanas/quantdata-mcp.git

2. 자격 증명 가져오기

QuantData 계정에서 두 가지 값이 필요합니다. 브라우저를 여세요:

1. v3.quantdata.us에 접속하여 로그인합니다.

2. **개발자 도구(DevTools)**를 엽니다 (F12 또는 우클릭 → 검사) → 네트워크(Network) 탭으로 이동합니다.

3. 페이지를 새로고침합니다.

4. QuantData의 차트나 페이지를 클릭하면 API 요청이 나타납니다.

5. core-lb-prod.quantdata.us로 향하는 요청을 클릭하거나 상단에서 /api로 필터링합니다.

6. **요청 헤더(Request Headers)**에서 다음을 찾아 복사합니다:

   • authorization — 인증 토큰 (eyJ...로 시작)

   • x-instance-id — 인스턴스 ID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 형태의 UUID)

다음과 같은 모습이어야 합니다:

3. 설정 실행

quantdata-mcp setup \
  --auth-token "eyJhbGci..." \
  --instance-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

이 명령은 QuantData 계정에 11개의 데이터 도구가 포함된 전용 페이지를 생성하고 설정을 ~/.quantdata-mcp/config.json에 저장합니다.

4. Claude에 추가

Claude Code

프로젝트의 .mcp.json (또는 전역 ~/.claude/mcp.json)에 추가하세요:

{
  "mcpServers": {
    "quantdata": {
      "command": "quantdata-mcp",
      "args": ["serve"]
    }
  }
}

Claude Code를 재시작하세요. MCP 서버 목록에 quantdata가 나타나야 합니다.

Claude Desktop

Claude Desktop 설정 파일에 추가하세요:

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

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

{
  "mcpServers": {
    "quantdata": {
      "command": "quantdata-mcp",
      "args": ["serve"]
    }
  }
}

참고: quantdata-mcp가 시스템 PATH에 있어야 합니다. 찾을 수 없는 경우 전체 경로를 사용하세요:

which quantdata-mcp   # find the path

{ "command": "/Users/you/.local/bin/quantdata-mcp", "args": ["serve"] }

또는 PATH 걱정 없이 uvx를 사용하세요:

{
  "command": "uvx",
  "args": ["--from", "git+https://github.com/zzulanas/quantdata-mcp.git", "quantdata-mcp", "serve"]
}

Claude Desktop을 재시작하세요. 도구 목록에 QuantData 도구가 나타납니다.

사용 가능한 도구

시장 개요

익스포저 (그릭스)

프리미엄 흐름

주문 흐름 및 거래 통계

변동성 및 가격 책정

미결제 약정 및 맥스 페인

공통 매개변수

모든 도구는 티커/날짜 제어를 위해 다음 매개변수를 허용합니다:

필터 매개변수

필터링을 지원하는 도구는 다음 선택적 매개변수를 허용합니다:

사용 예시

Claude에게 다음과 같이 질문하세요:

• "지금 가장 큰 GEX 월은 무엇인가요?"

• "어제 오전 10시 30분의 DEX 월을 보여줘"

• "거래 측 통계를 가져와줘 — 오늘 풋과 콜 중 어느 쪽이 더 공격적인가요?"

• "지난 목요일의 장 시작 시점과 마감 시점의 GEX 프로필을 비교해줘"

• "4월 17일 월간 만기 AAPL 감마 익스포저를 보여줘"

• "오늘 SPX의 OTM 전용 순 드리프트는 무엇인가요?"

• "주문 흐름을 보여줘 — 프리미엄 5만 달러 이상의 콜만"

• "오늘 SPX 6600 콜의 OHLCV를 가져와"

• "30일 룩백 기간의 IV 랭크는 얼마인가요?"

• "모든 만기에 걸친 GEX 기간 구조를 보여줘"

멀티 티커 지원

모든 도구는 옵션 거래가 가능한 모든 티커에서 작동합니다. ticker="AAPL" (또는 원하는 심볼)을 전달하기만 하면 됩니다.

중요: SPX, SPY, QQQ는 일일 만기가 있습니다 (0DTE가 기본적으로 작동). AAPL이나 TSLA와 같은 주식 옵션의 경우, expiration_date를 유효한 만기일(예: 월간 세 번째 금요일)로 설정해야 합니다. 그렇지 않으면 데이터가 비어 있을 수 있습니다.

> Show me TSLA GEX walls for the April 17 monthly
> qd_get_exposure_by_strike(ticker="TSLA", expiration_date="2026-04-17")

과거 데이터

모든 도구는 과거 분석을 지원합니다. 도구에 date=를 전달하거나 qd_set_page_date를 사용하여 컨텍스트를 전환하세요:

> Set the date to 2026-03-26 and show me the GEX walls at 10:00 AM

> qd_set_page_date(date="2026-03-26")
> qd_get_exposure_by_strike(greek_type="GAMMA", time_minutes=600)

시간 스크러빙: time_minutes = 자정부터의 분 (570 = 오전 9:30, 720 = 오후 12:00, 960 = 오후 4:00).

참고: date는 유효한 거래일이어야 합니다 (주말이나 시장 휴장일 제외).

작동 원리

QuantData는 공식 API를 제공하지 않습니다. 이 서버는 웹 앱의 리버스 엔지니어링된 REST 엔드포인트를 사용합니다. 각 사용자는 "페이지"에 "도구"(차트 위젯)를 가지고 있으며, 설정 명령은 MCP 서버가 쿼리할 수 있도록 11가지 데이터 유형이 모두 포함된 전용 페이지를 생성합니다.

아키텍처:

Claude --> MCP (stdio) --> quantdata-mcp server --> QuantData REST API

자격 증명과 도구 ID는 로컬의 ~/.quantdata-mcp/config.json에 저장됩니다.

명령어

quantdata-mcp setup --auth-token <TOKEN> --instance-id <ID>  # One-time setup
quantdata-mcp serve                                           # Start MCP server (used by Claude)

요구 사항

• Python 3.11+

• 활성 QuantData 구독

문제 해결

"Config not found" 오류: 먼저 quantdata-mcp setup을 실행하세요.

인증 오류 (401): 토큰이 만료되었습니다. 네트워크 탭에서 새 토큰을 가져와 설정을 다시 실행하세요. 기존 페이지와 도구가 재사용됩니다:

quantdata-mcp setup --auth-token "NEW_TOKEN" --instance-id "SAME_ID"

데이터 없음: 활성 QuantData 구독이 있는지, 쿼리하는 날짜에 시장이 열려 있었는지 확인하세요. 지수 외 티커(AAPL, TSLA)의 경우 expiration_date를 유효한 옵션 만기일로 설정했는지 확인하세요.

Claude Desktop에서 "No such file or directory": quantdata-mcp의 전체 경로를 사용하세요 (위 4단계 참조).

기여

버그 리포트, 추가 QuantData 위젯을 래핑하는 새 도구, 포맷터 개선, 문서화 등 모든 기여를 환영합니다. 개발 환경 설정, 새 MCP 도구 추가 방법, PR 전송 시 따라야 할 규칙은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT — LICENSE를 참조하세요.