Hcup Inpatient Stats

hcup-inpatient-stats

按主要诊断和年份统计的美国全国住院出院人数、总费用和脓毒症结局，数据来自美国医疗保健研究与质量局（AHRQ）的医疗保健成本与利用项目（HCUP）。

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

本项目可回答“全国有多少例心力衰竭住院病例，费用是多少”这类问题——这是流行病学和市场规模评估常用的数据，引用方式与 HFSA/AHA 一致：住院和费用数据引用 AHRQ HCUP。

工具

• condition_hospital_costs(year?, payer?, condition?) — 某一年度（2022 或 2017）全国费用最高的 20 种主要诊断病症，包含出院人数、总费用和每次住院的平均费用。可选择按一种病症（“heart failure”“sepsis”或 CCSR 代码）或一种预期付款方（仅限 2022 年：Medicare、Medicaid、私人保险、自费）筛选。
• sepsis_hospital_outcomes(period?, population?) — 2016–2021 年全国脓毒症（主要诊断）平均住院时长和每次住院平均费用，按是否同时存在 COVID-19 诊断，以及患者群体（65 岁及以上成人、18–64 岁成人、孕产妇、儿科、新生儿）分类。也报告 AHRQ 公布过具体数字年份（2016、2019、2021）的任何诊断项脓毒症住院人数——这一范围比主要诊断更广，并明确标注，绝不与主要诊断数据混用。

身份验证

无需密钥。

数据来源

• 美国医疗保健研究与质量局（AHRQ），医疗保健成本与利用项目（HCUP）——“按付款方划分的费用最高病症”统计简报系列（2022 年和 2017 年版）以及脓毒症结局统计简报（2016–2021 年）。这些是 AHRQ 基于全国住院患者样本计算并免费发布的汇总报告，无需账户或数据使用协议。

本工具包有意不使用的内容： HCUP 的全国住院患者样本（NIS）和全国再入院数据库（NRD）微观数据文件需付费购买，并受点击确认的数据使用协议约束。本工具包不会接触这些文件或任何需要该协议的内容——此处的所有数字均来自 AHRQ 自行发布的公开报告；这些报告提供相同的基础统计数据，且无需签署数据使用协议。

为何使用这些数字，而非实时查询： AHRQ 的交互式查询工具（公开品牌名称为“HCUPnet”和“HCUP Fast Stats”）已迁移至 Tableau Server 部署。它无需登录或账户即可响应普通浏览器流量——这不是数据使用协议或凭据限制——但其前端的 CloudFront 级 WAF 会向普通 HTTP 客户端返回 403，不受 User-Agent 或标头设置影响。这与 Cloudflare Worker 的数据中心出口 IP 会遇到的拦截属于同一类型，因此无法在此处可靠地实时查询。AHRQ 的静态统计简报报告（由 hcup-us.ahrq.gov 提供，不存在此类拦截）直接由发布方提供内容大致相同的汇总数据，因此本工具包改用这些报告构建。

更新方式： AHRQ 不定期发布新的统计简报（没有固定的年度发布周期——截至 2026-10-21，“费用最高病症”系列包含 2004、2006、2008、2011、2013、2017 和 2022 年版，没有 2021 年版）。请定期查看 AHRQ 的公开统计简报索引（无需账户），确认是否有更新的跨病症简报或脓毒症结局简报；如有，则将其表 1（以及任何按付款方划分的表格）重新录入 src/data.ts，并更新其中的 *_DATA_AS_OF 常量。没有 API 可供轮询——这是一项低频的手动转录工作，与目录中其他基于政府报告的工具包相同。

心力衰竭患病率——未公开制表

此工具包的验收标准要求提供一份来自 NCHS/CDC 公共表格的心力衰竭患病率数据。未找到此类表格。已检查：

• data.cdc.gov（Socrata）——在目录搜索 API 中，没有找到标题或描述与“heart failure prevalence”或“heart failure”匹配的数据集。chronicdata.cdc.gov（PLACES / BRFSS）发布了按县／人口普查区／地点划分的自报“冠心病或心绞痛”患病率——这是相关但不同的指标（冠心病／心绞痛，而非心力衰竭），本工具包不会以此替代心力衰竭数据。
• CDC NHIS（National Health Interview Survey）提供数据查询工具，但它是一个客户端应用；在本次构建过程中，未找到可发现的公共 JSON 端点，而且普通客户端访问 cdc.gov/nchs/nhis/health-conditions.htm 会收到 403 错误。
• 全国心力衰竭患病率数据（例如常见引用的约 670 万美国成年人）源自已发表的文献（AHA 的“Heart Disease and Stroke Statistics”更新），该文献通过对 NHANES 检查和问卷微观数据进行加权分析得出结果——NHANES 会公开原始微观数据（包括充血性心力衰竭相关问题），但 NCHS 并未据此发布现成的心力衰竭患病率表格；本工具包不会复现这项分析。

如果之后发现 NCHS/CDC 发布了公开的患病率表格，请将其添加为第三个工具，而不是重新开放这个工具。

说明

• 全文的分析单位都是“出院人数”／“住院人次”——也就是住院人次，而不是独立患者。一名患者一年内多次入院，会按每次住院分别计数。
• 费用指医院提供医疗服务所产生的成本（将 HCUP Cost-to-Charge Ratios 应用于账单金额），不是支付方支付的金额，也不包括单独计费的医生费用。
• 病症名称和 CCSR 代码来自 AHRQ 的 Clinical Classifications Software Refined (CCSR)，适用于 ICD-10-CM——这与 meps 用于查询病症的系统相同（mcps/meps/src/conditions.ts），不过本工具包使用的是自有的小型同义词映射，仅涵盖这些表格中实际出现的约 20–40 种病症，而非完整的 CCSR 分类体系。

快速开始

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

{
  "mcpServers": {
    "hcup-inpatient-stats": {
      "url": "https://gateway.pipeworx.io/hcup-inpatient-stats/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/hcup-inpatient-stats/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 都连接到同一个网关和相同的 1866+ 个数据源。唯一的区别是直接列出哪些工具包的工具；无论连接哪一个，ask_pipeworx 都可以访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/condition_hospital_costs \
  -H 'Content-Type: application/json' \
  -d '{"year":2022,"condition":"heart failure"}'

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

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

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

{
  "mcpServers": {
    "hcup-inpatient-stats": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-hcup-inpatient-stats"]
    }
  }
}

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-hcup-inpatient-stats

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Hcup Inpatient Stats data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT