Nursing Home Database

护理院数据库 — MCP

护理院数据库 模型上下文协议 服务的公开文档。它向 AI 助手和其他 MCP 客户端提供美国专业护理机构的搜索、详情、所有权和业主投资组合数据，包括 CMS 护士工时、人员流动率和检查评分。

网站： nursinghomedatabase.com
联系方式： 联系页面

MCP 端点

传输方式	可流式传输的 HTTP（通过 HTTPS 传输 JSON-RPC 2.0）
URL	https://mcp.nursinghomedatabase.com/mcp
身份验证	无需（公开访问）
服务名称	nhd-mcp
版本	1.4.0

发送标准 MCP 会话：initialize → notifications/initialized（可选；可能收到 HTTP 204）→ tools/list → 按需调用 tools/call。

工具

工具	用途
search_facilities	查找地址附近（或按名称／城市／州／所有权类型查找）的认证专业护理机构，以便根据护士工时、人员流动率和检查评分，从中筛选出三家以上的护理院
search_facilities_by_ownership	同样的搜索，但必须指定 CMS ownership 类型（For profit / Non profit / Government，或 list_distinct_values 返回的确切值）
summarize_facilities	按全国范围或分组统计护士工时、人员流动率、评级、床位和罚款等数据（样本量、平均值、最小值、最大值；中位数可选）。优先使用此工具，而不是分页调用 search_facilities
get_facility	按 CMS 服务提供者编号或网站 slug 查看一家护理院，返回与搜索相同的工时、人员流动率、检查、床位和处罚字段
compare_facilities	使用相同的架构比较最多 25 个 CCN／slug — 优先使用此工具，而不是循环调用 get_facility（MCP 每分钟限 60 次请求）
get_facility_changes	对比一家护理院在两个 CMS 月度文件中的字段级差异。默认比较最新文件与上一个快照。不包含业主姓名
get_facility_ownership	列出一家护理院的所有者及其角色
search_owners	按名称查找护理院业主
get_owner	查看业主旗下认证专业护理机构的投资组合
list_file_dates	列出数据库中的 CMS 月度快照日期，以便查看之前月份的数据
list_distinct_values	列出 ProviderInfo 字段（ownership、state、sffstatus、chainname 等）中不同 CMS 值及其计数
get_data_freshness	报告最新 CMS 文件的发布时间和所含行数

tools/list 会返回确切的 inputSchema 对象。

历史月份（filedate）

默认情况下，每次查询都会使用最新的 CMS 月度文件。要检索之前月份的数据：

1. 调用 list_file_dates（返回 current、按从新到旧排序的 filedates，以及未发布月份的 known_gaps）。
2. 在 search_facilities、search_facilities_by_ownership、summarize_facilities、compare_facilities、get_facility、get_facility_ownership、search_owners、get_owner 或 list_distinct_values 中，将其中一个日期作为 filedate（YYYY-MM-DD 或 YYYY-MM）传入。get_facility_changes 不接受 filedate；请传入 from 和 to。

CMS 快照使用每月第一天的日期（YYYY-MM-01）存储。像 2026-07 或 2026-07-15 这样的值会被规范化为 2026-07-01。未知日期会返回验证错误 — 请调用 list_file_dates，不要猜测。

search_facilities

查找某个地址附近经认证的 SNF，帮助你根据工时、人员流动率和检查评分，从三家以上的养老院中筛选候选对象。也可以按名称、城市、州或邮政编码搜索。

参数	类型	说明
q	string	机构名称自由文本
address	string	用于距离搜索的起点地址（例如 150 Corporate Woods Drive, Magnolia, TX 77354）
city	string	城市筛选条件
state	string	州筛选条件
zip	string	邮政编码筛选条件
radius_miles	number	直线距离半径，单位为英里；提供 address 时默认为 25
min_overall_rating	integer	CMS 总体星级评分下限（REST 接口已支持；此 MCP 工具也支持）
max_overall_rating	integer	CMS 总体星级评分上限（REST 接口已支持；此 MCP 工具也支持）
abuse_icon	string	按 CMS 虐待标记筛选（Y / N、true / false）（REST 接口已支持；此 MCP 工具也支持）
sffstatus	string	设置后，仅保留具有 CMS 特别关注机构（或候选机构）状态的养老院（REST 接口已支持；此 MCP 工具也支持）
ownership	string	CMS 所有权类型（ProviderInfo.ownership）。不区分大小写。前缀 For profit、Non profit 和 Government 分别匹配对应类型。调用 list_distinct_values 并设置 field=ownership，可获取 13 个精确值
sort	string	排序键（见下文的排序键）
limit	integer	结果数量上限
offset	integer	分页偏移量
filedate	string	可选的 CMS 月度快照，取自 list_file_dates（默认为最新月份）

如果无法解析提供的地址，API 会返回特定于该地址的验证错误。

机构数据（搜索和详情）

search_facilities（每个 items[] 行）和 get_facility（facility）会返回相同的扩展对象，因此筛选候选对象时无需逐家调用详情接口。

其中包含身份、位置和 CMS 星级评分（provnum、web、provname、lbn、address、city、state、zip、latitude、longitude、phone、overall_rating、survey_rating、quality_rating、staffing_rating、公开的 urls）。决策字段使用 CMS 键：

键	含义
tothrd	每位住户每天的护士总工时（HPRD）
rnhrd	每位住户每天的注册护士工时
totalnumberofnursestaffhoursperresidentperdayontheweekend	周末每位住户的护士总 HPRD
registerednursehoursperresidentperdayontheweekend	周末每位住户的注册护士 HPRD
totalnursingstaffturnover	护理人员流动率
registerednurseturnover	注册护士流动率
numberofadministratorswhohaveleftthenursinghome	已离职的养老院管理人员人数
weighted_all_cycles_score	加权健康检查评分（所有周期）
bedcert	经认证的床位数
restot	经认证床位中的住户人数
occupancy	入住率（住户人数 / 经认证的床位数）
fine_tot	罚款总额（美元）
fine_cnt	罚款次数
abuse_icon	CMS 虐待标记
sffstatus	特别关注机构状态
chain_id	连锁机构标识符
chain_name	连锁机构名称
ownership	CMS 所有权类型（例如 For profit - Corporation）
oldsurvey	标记（Y/N）：最近一次常规健康检查距今已超过两年
cycle_1_survey_date	最近一次常规健康检查的日期

距离（直线英里数，不是驾驶时间）

使用 address 调用 search_facilities 时：

• distance_miles 是从起点到该机构的哈弗辛直线距离，单位为英里。
• distance 是同一数值的别名。

这些值不是驾驶时间或公路里程。要获取驾驶时间，请对结果行使用 maps.google_dir / maps.apple_dir，或将坐标传递给地图工具。

排序键

在 search_facilities（以及 GET /api/v1/nh/facilities）中传入 sort。省略 sort 时，默认按 overall_rating 排序（星级降序）。从地址搜索时，使用 sort=distance 按距离从近到远排序。

sort 值	别名	顺序
overall_rating		星级降序（越高越好）
survey_rating		星级降序
quality_rating		星级降序
staffing_rating		星级降序
distance		英里升序（从近到远）
tothrd	total_nurse_hours	工时降序（越高越好）
totalnursingstaffturnover	nurse_turnover	离职率升序（越低越好）
weighted_all_cycles_score	survey_score	检查评分升序（越低越好）

search_facilities_by_ownership

返回与 search_facilities 相同的结果架构，且必须提供 ownership。当问题是“查找某地的政府／非营利／营利性养老院”时使用此工具。可与 state、city、zip 或 address 组合使用。先调用 list_distinct_values 并设置 field=ownership，以获取准确的 CMS 字符串。

参数	类型	必填	描述
ownership	string	是	CMS 所有权类型（前缀或精确值）
state	string	否	两字母州代码
city	string	否	城市筛选条件
zip	string	否	ZIP 筛选条件
address	string	否	距离搜索的起始地址
filedate	string	否	来自 list_file_dates 的 CMS 月度快照

summarize_facilities

汇总已认证 SNF 的 CMS ProviderInfo 数值字段。对于全国或分组统计（如政府与私营机构的工时、各州均值等），优先使用此工具，而不是分页调用 search_facilities。均值按机构等权计算（不按床位加权）。缺少某项指标的机构仅从该指标的 n／均值／最小值／最大值计算中排除，不会填补缺失值。结果不代表因果关系。不能替代对指定养老院调用 get_facility。

参数	类型	必填	描述
metrics	array of strings	是	1–20 个键：tothrd、rnhrd、weekend_tothrd、weekend_rnhrd、totalnursingstaffturnover、registerednurseturnover、weighted_all_cycles_score、overall_rating、survey_rating、staffing_rating、quality_rating、bedcert、restot、fine_tot、fine_cnt、occupancy。同义名称：total_nurse_hours、nurse_turnover、rn_turnover、survey_score
group_by	string	否	ownership、ownership_kind（Government / For profit / Non profit）、state、overall_rating、staffing_rating、survey_rating、quality_rating、sffstatus、abuse_icon。省略时返回一行全国（或按筛选条件限定）的数据
ownership	string	否	与 search_facilities 相同的前缀／精确值筛选条件
state	string	否	两字母州代码
city	string	否	必须同时提供 state
zip	string	否	ZIP 筛选条件
abuse_icon	string	否	与 search_facilities 相同
sffstatus	string	否	与 search_facilities 相同
min_overall_rating	integer	否	1–5
max_overall_rating	integer	否	1–5
include_median	boolean	否	默认为 false。设为 true 时，每个统计对象都会包含 median
filedate	string	否	来自 list_file_dates 的 CMS 月度快照

REST：GET /api/v1/nh/facilities/summary?metrics=tothrd,rnhrd&group_by=ownership_kind&include_median=true

响应中的 groups[] 各项包含 group_key、group_label、facilities_in_group，以及按规范指标键索引的 stats（包含 n、mean、min、max、可选的 median 和 unit）。facilities_in_scope 是符合筛选条件的机构数；每组各指标的 n 是该组该指标的非空值数量。未知指标键会返回 invalid_metric 和允许的指标列表。

0%／100% 的离职率和接近零的 HPRD 可能是报告数据造成的异常。

list_distinct_values

列出当前月度快照中某个字段的不同 CMS ProviderInfo 值及其行数。省略 field 可查看允许的字段目录。field=city 需要提供 state。

参数	类型	必填	描述
field	string	否	ownership、state、sffstatus、abuse_icon、certification、chainname、overall_rating、……
state	string	否	两字母州缩写（city 必填）
filedate	string	否	来自 list_file_dates 的 CMS 月度快照

compare_facilities

对单个快照中的最多 25 个 CMS 服务提供方编号或网页 slug，比较与 search_facilities 相同的判定字段。超过 25 个的 ID 会被丢弃。这不是逐月差异比较；如需此功能，请使用 get_facility_changes。

参数	类型	必填	描述
ids	array of strings	是	CMS 服务提供方编号或网页 slug。最多 25 个
filedate	string	否	来自 list_file_dates 的 CMS 月度快照

get_facility

按 CMS 服务提供方编号（provnum）或站点 slug 打开一家养老院。facility 对象与 search_facilities 的一行相匹配（营业时间、人员流动、检查、床位、处罚、地图链接）。

参数	类型	必填	描述
id	string	是	服务提供方编号或网页 slug
filedate	string	否	来自 list_file_dates 的 CMS 月度快照

get_facility_changes

比较一家养老院在两个 CMS 月度快照之间的差异。省略 from 和 to 可比较最新文件与前一个快照。changes 按字段列出差异：星级、护士工时、人员流动、加权检查分数、CMS 虐待标记、Special Focus 状态、所有权类型（营利性／非营利性／政府所有，而非所有者姓名）、罚款、床位、住户人数和入住率。如果某家养老院未出现在两个文件中的一个，found.from 或 found.to 会显示为 false。这不代表该机构已关闭。

参数	类型	必填	描述
id	string	是	CMS 服务提供方编号或网页 slug
from	string	否	较早的 filedate（YYYY-MM-DD 或 YYYY-MM）。省略时使用 to 之前的快照
to	string	否	较晚的 filedate。省略时使用最新的 CMS 文件

get_facility_ownership

列出一家养老院的所有者及其角色。

参数	类型	必填	描述
id	string	是	服务提供方编号或网页 slug
filedate	string	否	来自 list_file_dates 的 CMS 月度快照

search_owners

按名称查找养老院所有者。

参数	类型	必填	描述
q	string	是	所有者名称搜索词
limit	integer	否	结果数量上限
offset	integer	否	分页偏移量
filedate	string	否	来自 list_file_dates 的 CMS 月度快照

get_owner

按 web_owner slug 打开某位所有者的认证 SNF 组合。

参数	类型	必填	描述
web_owner	string	是	所有者 slug 标识符
filedate	string	否	来自 list_file_dates 的 CMS 月度快照

list_file_dates

列出数据库中可用的 CMS 月度快照日期。无参数。返回 current、按日期从新到旧排列的 filedates，以及尚未发布月份的 known_gaps。

get_data_freshness

报告最新 CMS 源数据集的日期和行数。无参数。若要查询之前的月份，请调用 list_file_dates，并将 filedate 传给其他工具。

MCP Registry

已列入官方 MCP Registry，名称为 com.nursinghomedatabase/mcp。

• Registry 清单：server.json
• 搜索：https://registry.modelcontextprotocol.io/v0.1/servers?search=com.nursinghomedatabase

REST API（同一后端）

主站也提供 JSON 发现 API：

• GET https://www.nursinghomedatabase.com/api/v1/nh/capabilities
• GET https://www.nursinghomedatabase.com/api/v1/nh/file-dates
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?address=150+Corporate+Woods+Drive,+Magnolia,+TX+77354
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?address=150+Corporate+Woods+Drive,+Magnolia,+TX+77354&radius_miles=10&sort=distance
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?state=TX&min_overall_rating=4&sort=tothrd
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?state=TX&filedate=2026-07-01
• GET https://www.nursinghomedatabase.com/api/v1/nh/field-values?field=ownership
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?state=TX&ownership=Non+profit
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities/summary?metrics=tothrd,rnhrd,totalnursingstaffturnover&group_by=ownership_kind

REST 调用方可以像 MCP 工具一样，在 facilities 和 owners 端点传入 filedate=YYYY-MM-DD（或 YYYY-MM）。min_overall_rating、max_overall_rating、abuse_icon、sffstatus 和 ownership 是 GET /api/v1/nh/facilities 的查询参数。

MCP 和 REST 共用同一底层数据层。

示例：Cursor / IDE 配置

{
  "mcpServers": {
    "nursing-home-database": {
      "type": "streamableHttp",
      "url": "https://mcp.nursinghomedatabase.com/mcp"
    }
  }
}

许可证和数据

数据源自 CMS 及相关来源的公开数据。使用须遵守 nursinghomedatabase.com 上公布的条款。