Index Constituents

@pipeworx/index-constituents

六个主要美国及发达市场股票指数的当前成分股、权重和行业，以及一份附带日期的 S&P 500 纳入与剔除历史——基于实时 ETF 代理构建的时点指数成分数据，而非授权指数数据源。

属于 Pipeworx——一个连接 AI Agent 与 1779+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

工具

• index_constituents(index, limit?, offset?, sector?) — 某一指数（sp500、sp400、sp600、russell1000、russell2000、eafe）的当前股票成分：股票代码、名称、GICS 行业、权重和基金的“截至”日期。按权重降序排列。跟踪 ETF 同时持有的现金、抵押品和期货不包含在此处（请参阅 ishares_etf_holdings）。默认 limit 为 50；传入 limit: 600（上限）即可在一次调用中获取整个指数——约 503 行的 S&P 500 答案可按需获取，不会默认返回。
• ishares_etf_holdings(ticker, limit?, offset?, asset_class?) — 六只跟踪 ETF（IVV、IJH、IJR、IWB、IWM、EFA）之一报告的所有持仓，包括现金、抵押品和期货；每项持仓均标有自己的 asset_class，因此绝不会在未说明的情况下与股票合并。
• constituent_changes(index, from?, to?, limit?) — 附带日期的 S&P 500 纳入与剔除记录（index 必须为 sp500；其他五个指数没有公开的附日期变更表）。from/to 可接受年份（如“2024”）或 ISO 日期。

身份验证

无需密钥。两个上游都是公开、无需身份验证的页面。

数据来源

• iShares（BlackRock）——各基金为其自有指数跟踪 ETF 发布的每日持仓文件（IVV/S&P 500、IJH/S&P MidCap 400、IJR/S&P SmallCap 600、IWB/Russell 1000、IWM/Russell 2000、EFA/MSCI EAFE）。这是官方指数成分数据的代理，而非指数提供方自己的数据：S&P 和 Russell 不免费发布其成分文件，因此基金实际报告的投资组合——该组合紧密跟踪其指数——是最接近的公开时点替代数据。权重是 ETF 自身投资组合的权重，并非 S&P/Russell 发布的指数权重，可能存在细微差异（现金拖累、抽样、公司行动的时间差）。
• Wikipedia——“List of S&P 500 companies”和“Historical components of the S&P 500”（后者是此套件中 constituent_changes 的数据来源：一份由社区维护、附有引用依据的表格，记录自 1963 年以来每次由 S&P 公布的 S&P 500 成分调整，并列出其生效日期和说明原因）。

复用说明（已于 2026-10-12 核查）。 BlackRock 网站条款（blackrock.com/corporate/compliance/terms-and-conditions）规定，网站内容“仅供个人非商业用途”，未经“BlackRock 书面许可”，不得“为公共或商业目的进行分发、修改、传输、复用、转载……”。此套件不会存储、镜像或再分发持仓文件：每次调用都会实时获取基金的当前文件（在边缘缓存一天，方式与普通浏览器的缓存相同），并返回该次调用所解析的行。根据代理与镜像规则（CLAUDE.md，fleet #1389——“每次请求实时调用上游无需明确授权；只有批量复制/镜像才需要”），这属于代理访问，而非再分发；此套件和 Pipeworx 自身的存储中均未内置任何数据集。Wikipedia 的内容采用 CC BY-SA 4.0 许可，允许复用，包括附带署名的商业复用——每个响应中的 source 都会注明 Wikipedia 和相应页面。

备注

• iShares 持仓文件的列布局因基金而异： IJH 和 IJR 会增加一个「Type」列，并将权重字段命名为「Market Weight」， 而不是「Weight (%)」。此工具包按列名而非位置读取表头，因此列顺序调整不会导致数据错位而不被察觉。
• 每个响应中的 data_as_of 都是文件中该基金自身的「Fund Holdings as of」日期， 而不是 Pipeworx 获取文件的时间——请用它来判断数据的新鲜度。
• S&P 500 持仓文件中包含少量非股票行（现金、 抵押品，以及用于在再平衡期间保持满仓的期货合约），尽管该基金的投资目标是「全部投资于股票」；这些行 不会纳入 index_constituents，并会在 ishares_etf_holdings 中明确标注。
• 目前，constituent_changes 仅涵盖 sp500。其他五个指数 都没有免费的、带日期且有来源引用支持的变动表——要添加此类表，就需要采用不同且很可能付费的数据源。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "index-constituents": {
      "url": "https://gateway.pipeworx.io/index-constituents/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/index-constituents/mcp 上的 tools/list 会返回上表中的工具， 以及 Pipeworx 的共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和 网关全局工具集中的其他工具。因此，你看到的工具数量会多于此表：目前，单工具包端点除了 该工具包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是判断当日情况的权威依据。

这是有意为之，并非意外地进行了多路复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 路由到整个目录——无需你再添加第二个 MCP 服务。目前无法在不包含这些工具的情况下挂载工具包端点；如果额外的架构定义消耗的上下文超过了路由功能带来的价值， 请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具， 而不仅仅是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1779+ 个数据源。唯一的区别是直接列出 哪个工具包的工具；通过任意一个端点调用 ask_pipeworx，都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/index_constituents \
  -H 'Content-Type: application/json' \
  -d '{"index":"sp500","limit":600}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/index_constituents。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "index-constituents": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-index-constituents"]
    }
  }
}

也可以直接运行，以确认服务正常启动：

npx -y @pipeworx/mcp-index-constituents

它通过 stdin/stdout 使用 MCP 协议，并为仅限此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接提供的任何共享元工具。数据源和工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你也可以用通俗语言提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Index Constituents data" })

网关会选择合适的工具并自动填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT