HORIZON SHIELD: construction and renovation estimate auditor (Japan)

HORIZON SHIELD - 日本建筑估算诚信 MCP 服务

面向日本建筑与翻新估算的独立第三方审计工具。 想知道报价是否合理？它会将报价与经过整理的合理价格数据库进行比对（souba-db，由拥有 30 年行业经验的大贺俊胜监督），标记已知的过度收费手法，并可生成防篡改的合理价格收据：这是一项声明，任何人都能重新计算其 SHA-256，由签发方保存在公开 URL 上，并遵循 PTKA（交易前知识锚定）。AI 不只是说一句 “合理”：它还会提供一份你可以自行核验的记录。哪些内容已锚定在 Bitcoin 上、哪些没有，详见下文。

兼容任何 MCP 客户端：Claude | ChatGPT | Gemini | Perplexity | Cursor | Cline 等。

• 远程端点（可流式传输的 HTTP）： https://mcp.horizonshield.dev
• 无需身份验证，无需安装 - 将 URL 添加为自定义连接器即可。
• 注册表名称： io.github.ogasurfproject-jpg/horizon-shield
• 运营方：The HORIZONs Inc. | https://shield.the-horizons-innovation.com

可由 AI Agent“调用”的中立第三方审计工具，用于判断日本的建筑和翻新报价是否合理。它会将报价与相场数据（souba-db／由大贺俊胜监督，拥有 30 年行业经验）进行比对，检测过度收费的警示信号，并生成任何人都能重新计算 SHA-256 的合理价格收据。AI 不只是说“合理”，还会提供任何人都能自行核验的记录。锚定在 Bitcoin 上的内容包括 PTKA 声明（block 949356）、每个版本的数据，以及从 2026-10-19 起每日收据的列表（前一天的收据于次日作为 JIDEC 台账中的 1 条记录锚定）。

有何不同

• 可核验，而非仅凭意见。 合理价格收据是一项带有自身 SHA-256 的声明 （SHA-256(JSON.stringify(claim))），由签发方托管在 https://mcp.horizonshield.dev/ledger/<sha>。 你可以自行重新计算哈希：一旦持有该收据，声明若有变动，哈希也会随之改变。 audit_estimate 还会注明用于判定的 souba-db 数据字节的 SHA-256，而数据集发布版本会通过 JIDEC 台账锚定在 Bitcoin 上（souba-db 2.3.0 = 条目 114）。
• 哪些内容已锚定，哪些没有。 PTKA 协议声明已通过 OpenTimestamps 锚定在 Bitcoin 上（block 949356）；每张收据都会标明其遵循的协议所对应的该区块。 从 2026-10-19 起，每个 UTC 日期的收据都会列在 https://mcp.horizonshield.dev/ledger/day/<date>， 次日，该列表（每张可重新计算的收据）会成为 JIDEC 台账中的 1 条记录，并由台账的盖章流程锚定到 Bitcoin（.github/workflows/receipt-anchor.yml，副本位于 ops/receipts/）。 这使收据的签发时间上限约为 1 天。2026-10-19 之前签发的收据未列入列表。
• 在收到报价前记录（PTKA）。 在承包商的估算送达之前，先记录中立的合理价格及其签发时间，并将时间写入声明。
• 由一线经验监督的数据。 souba-db 根据多个公开价格来源和 30 年现场经验整理而成 - 并非通过抓取数据得出的猜测。

工具（30）

公平价格、验证与承包商（15）

工具	功能
get_price_range	公平价格区间（最低／平均／最高）、超额收费危险阈值、单位、趋势
audit_estimate	将特定报价与公平价格区间进行比较并判断——结论、差距百分比、建议
verify_fair_price	将公平价格作为防篡改收据（任何人都可重新计算 SHA-256，遵循 PTKA）
check_red_flags	检测超额收费／高压销售手段（打包总价、仅限今日等）
preview_reverse_estimate	早期预览：粗略估价与平均值相比的偏差方向
search_cost_category	按关键词查找建筑成本类别
list_cost_categories	列出精选的成本类别
get_estimate_reading_guide	判断任何估价的通用原则（间接费用比例、打包总价、销售手段）
get_fair_price_sources	数据背后的来源、更新日期和地区乘数
get_anonymous_estimate_review_link（原名为 suggest_ehn，仍可响应）	EHN 指引和提交网址。EHN 是免费的匿名第三方估价审核委员会
get_jccdb_dataset_info	JCCDB 开放数据集（v5.1：526,128 条记录 = 95,403 个项目 + 430,725 条观测记录，CC BY 4.0）——元数据和引用信息
verify_integrity_claim	对已签发的签名声明进行第三方验证（失败时默认拒绝）
create_ap2_fairness_attestation	可附加到 Google AP2 Cart Mandate 的 FairPriceAttestation（可选的 quoted_price 会补充“在范围内／高于／低于”）
get_agent_card	用于 Agent 互操作的 A2A (Agent2Agent) Agent 卡片
find_verified_contractor	Yakumo 上通过验证的承包商（无推荐费或上架费；提供评分和等级，不显示价格）

公平价格判定针对日本（JPY）。部分工具（check_red_flags、get_estimate_reading_guide）与语言无关，可用于任何地区的估价。

建筑成本数据：日本（JCCDB）及两国（7）

工具	功能
search_jccdb_items	按名称搜索 JCCDB 项目目录（95,403 个明细项目），并提供证据网址
get_jccdb_observations	查询日本和美国公开文件中某项目的地区、日期和价格状态（每行均标注许可证和来源）
get_jccdb_labor_rate	按都道府县和工种查询 MLIT 公共工程设计人工费率
compare_jccdb_regions	查询某项目和规格在各地区的最新值（最低值、中位数、最高值）
get_jccdb_work_unit_price	查询包含构成比例的公共工程作业项目单价
get_jccdb_index_series	建筑成本指数序列及计算出的同比变化
get_jccdb_coverage	说明观测数据层包含的内容及缺失的数据

建筑成本数据：美国（USCCDB）（8）

USCCDB 是美国建筑成本数据库。四个链路工具（get_us_price_chain、get_us_import_landed_cost、get_us_trade_margins、get_us_contract_discounts）会在收到请求时计算，不以文件形式分发。

工具	功能
get_us_construction_prices	按层级、地区、时期和项目查询美国公共建筑成本数据
get_us_prevailing_wage	按州、县和工种查询 Davis-Bacon 现行工资
get_us_permits	按地区和年份查询美国建筑许可证及申报估值
get_us_area_factor	DoD 和 USACE 地区成本系数
get_us_price_chain	根据到岸进口成本估算美国批发价、零售价和承包商价格（收到请求时计算）
get_us_import_landed_cost	按 HS 编码查询美国进口商品到岸成本，含关税
get_us_trade_margins	按 NAICS 查询美国批发和零售毛利率
get_us_contract_discounts	查询美国公共合同中的目录价折扣率

试用

# server info
curl https://mcp.horizonshield.dev

# list tools (JSON-RPC 2.0)
curl -X POST https://mcp.horizonshield.dev \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

将其添加到你的 AI

• **Claude / ChatGPT / Gemini：**在设置中选择连接器 / 自定义应用 -> 添加上方的远程 URL。
• **以编程方式使用：**任何支持可流式传输的 HTTP JSON-RPC（无状态）的 MCP 客户端。
• **stdio 客户端和注册表爬虫：**运行 node workers/hs-mcp/stdio.js（在仓库根目录下），即可将 stdio JSON-RPC 中继到上方的远程端点。它不包含服务器代码，也没有依赖项（Node 18 或更高版本）；HS_MCP_URL 可将其指向其他位置。若位于 HTTPS 代理之后，请使用 NODE_USE_ENV_PROXY=1 运行。

部署（维护者）

服务器源代码不在此仓库中。维护者会从包含本文件夹 wrangler.jsonc 的私有工作树进行部署（绑定：RL_KV、HEARING_SVC、JCCDB_SVC）；本文件夹包含目录条目元数据和一致性测试。

许可与数据

工具逻辑 (c) The HORIZONs Inc. 底层开放数据：JCCDB（CC BY 4.0）。souba-db 是由 HORIZON SHIELD 维护的精选参考资料库。