Realdentalcosts Mcp

realdentalcosts-mcp

为你的 AI 助手提供价格透明的数据源。 网上流传的大多数牙科费用数字都是猜测、广告文案，或是无法追溯来源的平均值。此服务为你的助手提供结构化、可引用的数据集：覆盖 51 个美国州（含 DC）和 200 多个城市的 12 种常见牙科治疗价格，以及一个逐项检查治疗方案的工具，其依据仅为有来源、标注日期的数据。

数据来自 Real Dental Costs US Dental Cost Index 2026：每个数字都附有来源、统计期，以及它是观测值还是估算值（详情和许可见下文）。

快速开始

无需安装，直接通过 npx 运行。

npm 包目前仍为 0.2.0 版本（4 个工具）。远程服务（https://mcp.realdentalcosts.com/mcp）和下方的 Docker 镜像包含全部 14 个工具。

Claude Desktop / Claude Code

添加到你的 MCP 配置（claude_desktop_config.json 或 .mcp.json）：

{
  "mcpServers": {
    "realdentalcosts": {
      "command": "npx",
      "args": ["-y", "realdentalcosts-mcp"]
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "realdentalcosts": {
      "command": "npx",
      "args": ["-y", "realdentalcosts-mcp"]
    }
  }
}

保存后重启客户端。此服务通过 stdio 完全离线运行，无需 API 密钥、不会发起网络请求，也不收集遥测数据。

使用 Docker 运行

镜像 tresor4k/realdentalcosts-mcp （linux/amd64、linux/arm64、非 root 用户）包含数据，并运行相同的 stdio 服务：

{
  "mcpServers": {
    "realdentalcosts": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "tresor4k/realdentalcosts-mcp:latest"]
    }
  }
}

工具

dental_cost_by_state

某项治疗在美国一个州的现金价格低值／平均值／高值，并与全国平均值和该州的牙科费用指数进行比较。

procedure: "implant"   state: "CA"
→ California: $4,780 – $5,733 – $7,290 (observed state average, modelled band)
  National average: $3,760 – $4,507 – $5,733
  +27.2% vs. national average · Restorative Cost Index 127

dental_cost_by_city

特定城市观测到的单颗种植牙平均费用和诊所数量（206 个城市，开放数据 DOI 10.5281/zenodo.20819438），并附上该州的种植牙价格区间以供参考。城市级别仅发布种植牙数据系列；来源网站在 2026 年 7 月的数据完整性工作中停用了按城市划分的贴面／牙套数据。

city: "Los Angeles"   state: "CA"
→ 567 clinics
  Implants avg $4,500 (CA implant band $4,780 – $7,290)

治疗方案工具

每个数字都附有 source_url 和 period（或 effective_date）；如果某个数据单元格缺失，则返回 status: "no_source_at_this_level" 并提供上一级的数据，绝不会返回数字。Medicaid 金额是按申报项目支付的金额（T-MSIS），不是消费者价格。

• benchmark_treatment_plan — state、lines[{code|procedure, qty?, quoted_usd?}]（1-10）、coverage?（仅类别）。每个项目包括：该州的现金价格区间（附观测值／估算值标记）、Medicaid 支付的 p25／中位数／p75、官方收费表及其 schedule_scope、报价所处位置；另有该州成年人的 Medicaid 规定。未包含在已发布的 61 个 CDT 代码中的代码将返回 not_covered。
• medicaid_adult_dental_rules — 级别、计划摘要、年度上限、附引文的正畸和种植牙政策、通过 Medicaid 结算的牙医占比、收费表。
• medicaid_paid_by_code — code、state?：全国数据及 2018-2024 年数据系列、州级数据单元格、排名和官方收费。
• low_cost_dental_options — state、county?：牙科学校、健康中心和医疗服务短缺地区认定、Mission of Mercy、慈善项目、县级图谱数据行。

建模的 out_of_pocket_estimate 工具已移除。数据通过 npm run sync-data 从已发布的 API v1 同步（含 sha256 的清单位于 src/data/rdc/manifest.json）。隐私：HTTP 入口上的 GET /privacy。

dental_national_average

全部 51 个州及 DC 的全国平均值，以及平均价格最低和最高的州。

procedure: "braces"
→ National average: $2,503 – $6,352 – $10,014
  Cheapest: Indiana ($4,767 avg)
  Priciest: Nevada ($8,350 avg)

四种工具都接受 lang: "en" | "es"（默认值为 "en"）——项目标签、免责声明和 Medicaid 保障说明会切换为西班牙语，服务于该来源网站 /es/ 页面覆盖的美国西语裔市场。

每个响应都包含 source、reference_url 和 api_url 字段，以及每个项目对应的 basis（observed / estimated / national）和来源说明，确保数据可追溯至其所依据的已发布数据。

开放 JSON API（无需 MCP）

此 MCP 服务提供的相同数据也可通过免费开放的 JSON API获取——静态版本化端点，无需密钥，启用 CORS，并提供 OpenAPI 3.1 规范文档：

• 文档：https://realdentalcosts.com/en/api/
• 元数据和 DOI：https://realdentalcosts.com/api/v1/index/meta.json
• 全部 51 个州的市场数据：https://realdentalcosts.com/api/v1/states.json
• 单个州：https://realdentalcosts.com/api/v1/state/tx.json
• 12 项治疗项目：https://realdentalcosts.com/api/v1/procedures.json
• 各州的单项治疗项目：https://realdentalcosts.com/api/v1/procedure/dental-implant.json
• OpenAPI 3.1 规范：https://realdentalcosts.com/api/v1/openapi.json

许可条件因数据而异。Real Dental Costs 自有的数据集以 Zenodo 上各记录所注明的许可发布（例如种植牙系列，DOI 10.5281/zenodo.20531728）；使用时须注明来源：链接至 https://realdentalcosts.com 或引用 DOI。牙冠、贴面、牙齿矫正和假牙的州平均值来自 ASQ360/CareCredit Average Procedural Cost Study 2023-2024：这些数据仍归其发布者所有，不受 Real Dental Costs 许可协议涵盖，引用时必须注明该研究。

数据与方法

数据源自 Real Dental Costs 发布的开放数据集 US Dental Cost Index 2026：

• 数据集概念 DOI：10.5281/zenodo.20531728
• 完整指数：https://realdentalcosts.com/en/us-dental-cost-index/
• 交互式州际比较：https://realdentalcosts.com/en/compare/
• 方法说明：https://realdentalcosts.com/en/methodology/

每项治疗项目都带有 basis 字段。observed 州平均值为实测价格（种植牙 = Real Dental Costs 自有的实测系列；牙冠/贴面/牙齿矫正/假牙 = ASQ360/CareCredit Average Procedural Cost Study 2023-2024），其高低区间根据全国比率建模。estimated 项目没有各州来源：按各州的 Restorative Cost Index 缩放全国数据；该指数仅适用于修复治疗（种植牙/牙冠/假牙），不能用于预测正畸或美容治疗价格。national（美容）项目不包含人为编造的州际差异。全国平均值为全部 51 个州（含 DC）的算术平均值——并非另行编造的数字。本软件包中的数据均未经过手动编辑或捏造；可随时使用 node scripts/extract-cities.mjs <path-to-us-dental-cost-by-city-2026.csv> 重新生成 src/data/cities.json。

免责声明

本软件包提供的是市场研究价格数据，并非医疗建议、报价，也不保证任何特定牙医会收取相应费用。实际价格因诊所、服务提供者、保险计划和病例复杂程度而异。治疗前，请务必直接向持牌牙科服务提供者确认价格。

许可

MIT © tresor4k