关于 RepairWorth Auto Repair Quote Checker
RepairWorth Auto Repair Quote Checker 将 RepairWorth 的计算引擎封装为 MCP 服务,供司机核对美国汽车维修报价。它可检查金额、比较报价并查询州级估价法律,不提供市场价格或公平性判断。
主要功能
- 01核对报价总额与明细之差
- 02逐项比较两份报价
- 03按条件重算拖车费用
- 04分摊计划保养费用
- 05查询州级维修估价法律
适用场景
- 01检查报价总额是否与明细相符
- 02比较同一维修项目的两份报价
- 03按里程和费用重算拖车账单
- 04查询某州维修估价规定
MCP 相关
通过 stdio 向 MCP 客户端提供报价分析、报价比较、拖车估算、保养计划和州法律查询工具。计算仅依据调用者提供的金额。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
5收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lines | array | 否 | 报价单的明细项目:零件、工时、费用、税费、抵扣项、可退还费用。 |
| totalLow | number|string | 否 | 告知的总额或其下限。美元,最多两位小数:数字,或类似 "85"、"85.50"、"$1,234.50" 的字符串。 |
| totalHigh | number|string | 否 | 告知总额的上限(仅适用于区间)。美元,最多两位小数:数字,或类似 "85"、"85.50"、"$1,234.50" 的字符串。 |
| totalMode | enum | 否 | 报价单上所写总额的状态。fixed:`totalLow` 中的单一金额。range:`totalLow` 至 `totalHigh`。unknown、included 或 not-applicable:未告知总额,改为合计已知项目。fixed | range | unknown | included | not-applicable |
详细介绍
repairworth-mcp
一个通过 MCP 客户端运行 RepairWorth 汽车维修报价检查器计算引擎的模型上下文协议服务(stdio)。RepairWorth 是一家独立出版机构,帮助驾驶者在付款前读懂美国汽车维修报价。
该服务根据报价上填写的金额进行计算。它会检查总额是否与明细项目相符,逐项比较两份报价,根据拖车服务自身的条款重新计算拖车费用,并将计划中的保养费用分摊到若干个月。第五个工具会在一份汽车维修报价相关州法律数据集中查询某个州的信息。
它不会做什么。 该服务不包含市场价格或典型价格区间。它不会说明维修应该花多少钱,也不会判断报价是否合理。结果中的每一笔金额都是根据调用方提供的金额计算得出的。
这里不会重新实现计算引擎。网站的引擎文件未经修改,直接复制到 vendor/ 中;测试套件会检查每个工具返回的内容是否与引擎一致。
安装
需要 Node.js 18 或更高版本。可使用 npx 运行(无需安装),也可全局安装:
npx -y repairworth-mcp
# or
npm install -g repairworth-mcp
Claude Desktop(claude_desktop_config.json):
{
"mcpServers": {
"repairworth": {
"command": "npx",
"args": ["-y", "repairworth-mcp"]
}
}
}
Claude Code:
claude mcp add repairworth -- npx -y repairworth-mcp
从源代码安装:运行 git clone https://github.com/repairworth/repairworth-mcp.git,然后运行 npm ci 和
node bin/repairworth-mcp.js。
工具
| 工具 | 返回内容 |
|---|---|
analyze_quote | 一份报价:其支持的总额、已知项目金额之和、未填写金额的项目,以及告知的总额与明细项目之间的差额。 |
compare_quotes | 同一项工作的两份报价:价格差额区间(B 减 A)、存在差异的项目,以及两份报价中描述不同的工作范围项目。 |
maintenance_plan | 计划中的服务项目和可选的每月预留金额,以总额和 1 到 240 个月期限内的每月金额表示。 |
towing_estimate | 根据基础费用、包含的距离、总距离、每英里或公里费率及其他费用重新计算的拖车报价。 |
state_estimate_law | 一个美国州或 DC:来自“美国各州汽车维修报价法律”数据集的条目,包含其状态、引用信息和官方 URL。 |
analyze_quote 和 compare_quotes 使用的函数与上述链接的汽车维修报价检查器相同。
towing_estimate 使用网站拖车费用计算器的计算函数,
maintenance_plan 则使用其保养费用规划工具的计算函数。
输入
- 金额可以是数字,也可以是字符串,例如
"85"、"85.50"或"$1,234.50",最多保留两位小数。 - 项目或总额都有状态:
fixed(固定金额)、range(low到high)、unknown(报价未提供金额)、included(已包含在其他项目中)或not-applicable(不适用)。只有fixed和range状态带有金额。其他三种状态绝不会按零计算。 - 抵扣额使用正数,并设置
sign: -1。可退款费用(例如旧件押金)作为设置了conditionalRefund: true的项目处理:该费用不计入总额,而是在退款字段中报告。 maintenance_plan使用调用方提供的服务项目、月份数和价格。引擎不包含保养计划或服务间隔数据。- 遇到未知键时会拒绝输入,而不是忽略,因此拼写错误的输入不会在不提示的情况下改变总额。
结果
四个计算工具都会以 JSON 形式原样返回引擎结果。金额以整数形式表示,单位为美分
(displayLowCents: 140000 即 1,400.00 美元)。
如果引擎拒绝某项输入,返回值为 isError: true,并包含引擎自身的结果:valid: false,以及一个
errors 列表,其中的消息与网站上显示的消息一致。如果服务因输入结构不符合要求而拒绝调用(例如存在未知键,或某一行不是对象),则返回 isError: true 和一条 error 消息。
示例:对 analyze_quote 传入总额 1,400,以及金额分别为 800、500 和 80 的三项明细,返回结果中包括:
{
"valid": true,
"basis": "communicated-total",
"knownLowCents": 138000,
"knownHighCents": 138000,
"displayLowCents": 140000,
"displayHighCents": 140000,
"unknown": [],
"reconciliation": { "lowCents": 2000, "highCents": 2000 }
}
明细合计为 1,380 美元,而告知的总额为 1,400 美元:总额中有 20 美元未列明。
当两份报价的价格区间有重叠时,compare_quotes 会返回 direction: "overlap",并且不会指出哪份报价更低。只有当 comparableScope 为 true 时,价格差距才会比较同类项目。
各州关于维修估价的法律
state_estimate_law 接受一个两字母代码("CA"、"DC"),并通过 law 返回数据集中的原始记录,共 18 列:引文、官方 URL、关于书面估价的规定、未经新许可不得超出估价的规定、退还更换部件的规定、原文引述,以及核查日期。
这不是法律建议。请核实官方文本。 该数据集总结了公开法律文本,供研究和消费者参考。法律会发生变化,简短的摘要也可能遗漏例外情况。每条响应都会在 disclaimer 中重复此声明。
status | 含义 |
|---|---|
verified | 已查阅官方文本,且记录中列出了法规或规则。规则值来自该文本。 |
no_statute_found | 已于所列日期查阅官方来源,未发现专门的法规。这是一项否定性结论:无法通过引文证明。规则字段为空。 |
lead | 尚未查阅官方文本;记录中保留的任何引文或参考资料仅供后续查证,规则字段为空。 |
空值表示“无法根据已查阅的来源确认”,不表示“没有相关规定”。此处仅涵盖州级法律,不包括市级条例。RepairWorth 数据背后的来源列于其数据来源页面。
软件包的构建方式
vendor/engine.cjs是网站的引擎,附有两行声明。vendor/us-state-auto-repair-estimate-laws.csv是原始数据集,逐字节保持不变。vendor/SOURCE.json记录了二者的 SHA-256 值,测试会重新计算并校验。scripts/sync.mjs是维护者的脚本,用于从网站来源刷新vendor/和test/vectors.json。如果数据集与其公布的校验和不符,该脚本会拒绝复制。此软件包之外没有其他读取操作:从纯净的仓库副本运行npm ci && npm test即可。test/vectors.json保存了引擎自身测试套件的调用及引擎源代码给出的答案。每个调用都会通过 MCP 处理程序重放,返回结果必须完全一致。
npm ci
npm test
许可证
分为三部分,各自适用不同的条款(参见 LICENSE):
- 服务端代码:MIT。
- 计算引擎(
vendor/engine.cjs):保留所有权利,仅随此软件包分发。 - 数据集(
vendor/us-state-auto-repair-estimate-laws.csv):CC BY 4.0。引用格式:RepairWorth(2026)。美国各州汽车维修估价法律[数据集]。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。