pairbook-mcp

PairBook을 위한 MCP 서버 및 CLI입니다. PairBook은 4,700개 이상의 미국 주식과 ETF를 다루는 상관관계 및 ETF 중복 보유 엔진입니다. 가능한 1,130만 개의 쌍 중 어느 것이든 비교할 수 있습니다. 52,000개 이상의 인기 쌍은 발행사 제공 보유 종목 중복과 함께 미리 계산되어 제공되며, 그 외의 모든 조합은 주간 수익률 계열로부터 요청 시 계산됩니다. 기반 JSON API는 무료이고 정적이며 키가 필요 없고 미국 시장 마감 후 매 거래일마다 갱신됩니다.

AI 어시스턴트에게 "내 포트폴리오가 너무 집중되어 있나?", "QQQ와 VOO의 상관관계는 얼마나 되고, 보유 종목은 얼마나 겹치나요?" 또는 *"NVDA에 대한 분산 투자 대상을 찾아줘"*라고 물어보세요. 그러면 추측 대신 최신 출처가 명확한 수치로 답할 수 있습니다.

MCP 설정

Claude Code

claude mcp add pairbook -- npx -y pairbook-mcp

Cursor: 로 원클릭 설치

Claude Desktop: claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "pairbook": {
      "command": "npx",
      "args": ["-y", "pairbook-mcp"]
    }
  }
}

다른 MCP 클라이언트도 같은 방식으로 작동합니다: stdio를 통해 npx -y pairbook-mcp를 실행하세요.

Related MCP server: TickerAPI

도구

포트폴리오 분석

전체 포트폴리오(2~30개 포지션, 가중치 선택 사항)를 입력하면 중복된 포지션, 위험이 집중된 곳, 실제로 분산 효과가 있는 종목, 그리고 보유한 ETF가 내부적으로 중복되는지 여부를 알려줍니다:

pairbook portfolio AAPL:25 MSFT:25 NVDA:20 JNJ:15 XOM:15

RISK
  volatility     16.7%  (weighted average of the parts: 29.0%)
  beta vs SPY    0.99    market explains 73% of the moves (R2)
  max drawdown   -17.4%  (2024-12-05 to 2025-04-03, SPY: -16.9%)

RISK BUDGET  (share of portfolio risk vs share of capital)
  NVDA   ############  43.1% risk     20% capital  beta 2.18  risk engine  <- 20% of the capital but 43% of the risk
  AAPL   ########      27.1% risk     25% capital  beta 1.06  diversifier
  ...

MCP 도구 analyze_portfolio는 동일한 분석을 구조화된 JSON으로 반환합니다: 오일러 위험 기여도, 분산 비율 및 독립 위험 베팅, 함께 움직이는 상관관계 블록, SPY 대비 드로다운, 그리고 보유 ETF 간 발행사 출처의 중복 경고(QQQ와 VOO가 동일한 주식의 53.5%를 보유하고 있다는 사실은 다른 어떤 포트폴리오 도구도 보고하지 않습니다). 모든 공식은 docs/methodology.md에 문서화되어 있고, 불변식은 테스트로 검증되며, 어떤 것도 예측이나 조언이 아닙니다.

CLI

설치 없이 미널에서 동일한 데이터를 확인할 수 있습니다:

npx -y -p pairbook-mcp pairbook QQQ VOO

또는 npm i -g pairbook-mcp 실행 후:

pairbook QQQ VOO         # compare two assets
pairbook NVDA            # one asset's profile
pairbook search nvidia   # find a ticker
pairbook AAPL MSFT --json

종료 코드: 성공 시 0, 오류 발생 시 1(오류는 stderr로 출력됩니다). --json은 stdout에 유효한 JSON 문서 하나를 출력하므로 pairbook qqq voo --json | jq .correlation_weekly가 그대로 작동합니다.

DGRO vs SCHD  (data as of 2026-08-27)
  correlation   1y 0.74   3y 0.88   5y 0.93
  beta vs SPY   DGRO 0.65   SCHD 0.52
  volatility    DGRO 11.4%   SCHD 12.9%
  overlap       20.8% across 32 common holdings (issuer files 2026-08-26)
  https://www.pairbook.io/pair/dgro-vs-schd/

범위

PairBook은 상관관계, 중복 및 분산 구족를 다루는 전문 도구입니다. 시세, 펀더멘털, 뉴스를 제공하는 일반적인 시장 데이터 MCP 서버와 잘 어울리므로 둘 다 설치하고 어시스턴트가 이들을 결합하게 하세요.

데이터

모든 것는 무료 PairBook API에서 제공됩니다: 주간 수익률(1/3/5년 기간)로 계산된 상관관계, 발행사 포트폴리오 공시의 중복, 매 거래일마다 재계산됩니다. 데이터셋트는 DOI와 함게 CSV 다운로드로도 공개됩니다.

출처 표시하면 무료입니다(pairbook.io로 다시 연걀되는 링크). 미구 상장 주식 및 ETF만 해당됩니다. 여기의 어든 내욘도 투자 조언이 아닙니다.

개인정보 보호

서버와 CLI는 전적으로 사용자 머신에서 실해되며 읽기 전용입니다. 공개 시장 데이터를 가져오기 위해 단일 호스트(www.pairbook.io)를 호출하며, user agent의 버전과 surface 문자열로 자신을 식별하고 그 외의 어떤 것도 보내지 않습니다: 프롬프트 없음, 대화 콘텐츠 없음, 개인 데이터 없음, 텔레메트리 없음. 전체 정책: pairbook.io/privacy.

라이선스

MIT © VoidLab