pairbook-mcp

面向 PairBook 的 MCP 服务器和 CLI。PairBook 是覆盖 4,700+ 美国股票和 ETF 的相关性与 ETF 重叠引擎。1130 万个可能配对中的任意一对都可以比较：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 中，不变量由测试覆盖，且所有内容均非预测或建议。

命令行

同样的数据，直接在终端中使用，无需安装：

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 年窗口）计算，重叠数据来自发行方投资组合披露，每个交易日重新计算。该数据集还以 CSV 下载 的形式发布，并带有 DOI。

免费使用，但需注明出处（链接回 pairbook.io）。仅涵盖美国上市股票和 ETF。此处内容均不构成投资建议。

隐私

服务器和 CLI 完全在您的机器上运行，且为只读。它们仅调用一个主机（www.pairbook.io）来获取公开市场数据，在用户代理中通过版本和 surface 字符串标识自身，除此之外不发送任何内容：没有提示词、没有对话内容、没有个人数据、没有遥测。完整政策：pairbook.io/privacy。

许可证

MIT © VoidLab