MedPrice AI

mcp-medprice-ai

一个托管的 MCP 服务，向 AI 助手提供美国医院的 chargemaster 费用数据。

• MCP 端点：https://mcp.medprice.ai/mcp
• gRPC 后端：api.medprice.ai:443

在 Claude Code 中安装

claude mcp add --transport http mcp-medprice-ai https://mcp.medprice.ai/mcp

如需与项目中的所有人共享，请添加 --scope project（写入 .mcp.json）。如需在所有项目中使用，请使用 --scope user。

用法

该服务提供五个工具：

• list_hospitals — 返回受支持的医院及其 hospital_id、EIN、名称、structured_locations（地址及可用的地理编码坐标）、last_updated_on 和修订历史记录（每个修订的日期、revision_id，以及是否包含付款方专属费率数据）。
• get_hospital_chargemaster_cost — 查询单家医院某个计费代码的费用统计数据。
• list_hospital_code_costs — 分页查询所有具有匹配 chargemaster 条目的医院中某个计费代码的费用统计数据。比较同一项手术在多家医院的价格时，请使用此工具，而不要针对每家医院分别调用一次 get_hospital_chargemaster_cost。
• get_code_price_distribution — 返回所有医院某个计费代码价格的分布（百分位数、直方图，以及各百分位数对应的实际医院），由服务端计算。对于“这个价格算高吗？”这类问题，请使用此工具，而不要分页遍历 list_hospital_code_costs。
• list_code_types — 列出所有具有目录化费用数据的不同计费代码类型（例如 CPT、MS-DRG），以及每种类型的不同代码数量和医院报告总数。
• list_codes — 分页列出给定代码类型下的所有不同代码，并提供每个代码的原始 chargemaster 描述和报告该代码的医院数量。在查询价格之前，可用此工具了解某个代码系统中有哪些代码。

典型流程是先调用 list_hospitals，发现可用医院及其 ID，然后使用所需的 hospital_id 调用 get_hospital_chargemaster_cost；如果问题涉及多家医院的同一代码，而非某家特定医院，也可以直接调用 list_hospital_code_costs。安装后，你只需向助手提问，例如：

Medical City Alliance 的 MS-DRG 652 费用表价格是多少？

助手会调用 list_hospitals 查找医院的 ID，然后调用 get_hospital_chargemaster_cost，参数如下：

{
  "hospital_id": "3f9a1c2b8e4d5f6a7b8c9d0e1f2a3b4c",
  "code_type": "MS-DRG",
  "code": "652",
  "methodologies": ["fee schedule"]
}

并返回：

{
  "hospital": "MEDICAL CITY ALLIANCE",
  "found": true,
  "hospital_id": "3f9a1c2b8e4d5f6a7b8c9d0e1f2a3b4c",
  "results": [
    {
      "methodology": "fee schedule",
      "found": true,
      "cost": {
        "code_type": "MS-DRG",
        "code": "652",
        "min": "26851.11",
        "max": "190885.00",
        "avg": "34387.70",
        "median": "28084.07",
        "std_dev": "13735.94"
      },
      "description": {
        "hospital_name": "MEDICAL CITY ALLIANCE",
        "location": "3101 N Tarrant Pkwy, Fort Worth, TX, 76177",
        "code_description": "KIDNEY TRANSPLANT",
        "methodology_note": "fee schedule"
      }
    }
  ]
}

工具参考

list_hospitals

• page_size（可选）— 返回的最大医院数量。默认值为 500（一次调用返回当前注册表中的全部医院），上限为 500。
• page_token（可选）— 来自先前响应中 next_page_token 的不透明令牌，用于分页。如果 next_page_token 非空，请继续使用它调用，直到其为空；不要假定一页就是完整列表。

现在，每家医院的 revisions 数组都会为每个修订项包含一个 revision_id（以及 revision_date 和 has_payer_data）；将其作为 get_hospital_chargemaster_cost 的 revision_id 传入，即可查询该特定历史修订版的价格，而不是医院的最新版本。

get_hospital_chargemaster_cost

• hospital_id（必填）——来自 list_hospitals 的不透明医院标识符。
• code_type（必填）——代码系统，例如 APR-DRG、CDM、CPT、HCPCS、MS-DRG、RC。医院也可能支持其他专有代码类型。
• code（必填）——计费代码／收费主表代码。
• methodologies（可选）——包含 case rate、fee schedule、other、percent of total billed charges、per diem 的数组。每个条目返回一条结果，顺序与请求顺序一致，且每条结果都有自己的 found／cost／description。省略此参数或传入空数组时，将返回涵盖所有方法的单条汇总结果。
• revision_id（可选）——来自 list_hospitals 的 revision_id，用于查询特定历史版本的价格，而非医院的最新版本。

返回 hospital、found（如果 results 中至少找到一个条目，则为 true）、hospital_id 和 results——每个请求的方法对应一条结果（未提供 methodologies 时返回一条汇总结果），每条结果的结构为 { methodology, found, cost, description }。

list_hospital_code_costs

与 get_hospital_chargemaster_cost 类似，但会为每家有匹配收费主表条目的医院返回一条结果，无需预先提供 hospital_id。适用于查询“哪家医院的 X 最便宜”等问题，无需先调用 list_hospitals，再调用 N 次 get_hospital_chargemaster_cost。

• code_type（必填）——同上。
• code（必填）——同上。
• methodology（可选）——单个方法字符串，可选值同上。与 get_hospital_chargemaster_cost 不同，此筛选项始终为单个方法：它只会汇总所有方法或缩小到一个方法，不会为每家医院展开多条 results 条目。
• page_size（可选）——要返回的最大结果数。默认为 500（按当前登记表规模，一次调用即可返回所有匹配医院），上限为 500。
• page_token（可选）——来自上次响应中 next_page_token 的不透明令牌，用于分页。如果 next_page_token 非空，请持续使用该令牌调用，直到令牌为空，不要假设一页就是完整列表。

返回 results（每家医院的结构与 get_hospital_chargemaster_cost 响应相同，包含 hospital、found、hospital_id 和 results 数组；由于 methodology 筛选项为单数，该数组恰好包含一条结果）以及 next_page_token。仅包含有匹配条目（其最新版本）的医院，不会出现 found: false 条目。

get_code_price_distribution

在一次调用中由服务端计算所有报告该代码的医院的单个医院价格数据分布。

• code_type（必填）、code（必填）——同上。
• methodology（可选）——可选值同 list_hospital_code_costs；省略时汇总所有方法。
• min_sample_count（可选）——语义同 list_hospital_code_costs。
• bin_count（可选）——直方图柱数；默认为 16，最大为 200。
• reference_price（可选）——大于 0 时，hospitals_below_reference 会统计价格严格低于该值的医院数。
• statistic（可选）——PRICE_STATISTIC_AVERAGE（默认）、PRICE_STATISTIC_MEDIAN、PRICE_STATISTIC_MIN 或 PRICE_STATISTIC_MAX：要统计分布的单个医院价格指标。

返回 hospital_count、min／p10／q1／median／q3／p90／max、std_dev、直方图（histogram_lo、histogram_hi、histogram_bins、overflow_count）、每个百分位对应的 *_hospital 数据点（hospital_id、hospital_name、location、price），以及 hospitals_below_reference。hospital_count 为 0 表示没有医院报告价格。

list_code_types

无需参数。返回 code_types，每种类型对应一项，按代码数量从多到少排列；每项包含 code_type、code_count（该类型下已编入目录的不同代码数量）和 total_hospital_reports（该类型下所有代码的 hospital_count 总和，并非不同医院的数量）。不分页。

使用此工具可了解哪些代码系统包含数据，然后再使用 list_codes 深入查询。

list_codes

• code_type（必需）——要查询代码的代码系统，例如 CPT。来源为 list_code_types。
• page_size（可选）——要返回的结果数量上限。默认值为 500，最高为 500。
• page_token（可选）——用于分页的令牌，取自上一条响应的 next_page_token。如果 next_page_token 不为空，请持续使用该令牌调用，直到令牌为空，不要假定一页包含完整列表。

返回 codes（每项包含 code、raw_description——原始 chargemaster 文本，不一定是人类可读的手术名称；以及 hospital_count——在各医院最新修订版中报告该代码的不同医院数量）、next_page_token 和 total_count（所有页面中匹配代码的总数）。使用此工具可了解代码系统下有哪些代码，然后再使用 get_hospital_chargemaster_cost 或 list_hospital_code_costs 查询价格。

开发

在本地针对生产 gRPC 后端运行

GRPC_HOST=api.medprice.ai:443 npx tsx src/index.ts

在本地针对自定义 gRPC 后端运行

GRPC_HOST=<host:port> npx tsx src/index.ts

作为 HTTP 服务运行

TRANSPORT=http GRPC_HOST=api.medprice.ai:443 npx tsx src/index.ts

所有 MCP 请求都发送到 POST /mcp。PORT 默认为 3000。

测试 gRPC 连接

GRPC_HOST=api.medprice.ai:443 npx tsx src/test.ts

Docker

构建

docker build -t mcp-medprice-ai .

运行

docker run --rm -p 3000:3000 \
  -e GRPC_HOST=api.medprice.ai:443 \
  mcp-medprice-ai

镜像默认设置了 TRANSPORT=http 和 PORT=3000。如有需要，可覆盖 PORT：

docker run --rm -p 8080:8080 \
  -e GRPC_HOST=api.medprice.ai:443 \
  -e PORT=8080 \
  mcp-medprice-ai