关于 OwnerSpec
OwnerSpec MCP 服务为家庭水处理、管道和空气设备问题提供带来源的资料、诊断、配件匹配与计算器，面向需要可核查答案的 AI Agent。答案附引用网址和事实核验日期。
主要功能
- 01搜索指南、计算器、配件和评测
- 02获取带来源的页面与速答
- 03解读水质报告并诊断问题
- 04匹配替换配件和产品推荐
- 05运行计算器并规划维护
- 06提供水硬度换算和软水器 sizing
适用场景
- 01根据水质检测结果查看 EPA 限值
- 02按设备型号查找适配滤芯或灯管
- 03估算软水器容量与盐效能
- 04生成附来源的家庭设备维护计划
MCP 相关
向 MCP 客户端提供只读工具、资源和 answer_from_ownerspec 提示词；部分工具可在支持 MCP Apps 的宿主中显示交互视图。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://ownerspec.com/mcpclaude mcp add --transport http com-ownerspec https://ownerspec.com/mcp{"mcpServers":{"com-ownerspec":{"type":"http","url":"https://ownerspec.com/mcp"}}}在 Cursor 中打开{"servers":{"com-ownerspec":{"type":"http","url":"https://ownerspec.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-ownerspec":{"type":"http","url":"https://ownerspec.com/mcp"}}}{"mcpServers":{"com-ownerspec":{"serverUrl":"https://ownerspec.com/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
8| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| layer | enum | 否 | 限定为一个层级：guides（诊断）、calculators（计算尺寸）、parts（将型号与零件匹配）、reviews（比较产品）guides | calculators | parts | reviews |
| limit | integer | 否 | 结果数量上限（默认值为 5） |
| query | string | 是 | 搜索词，例如“iron well water orange stains”或“RCC7 filters” |
| topic | string | 否 | 可选主题 slug，例如 softening、filtration、iron、reverse-osmosis、uv、testing |
详细介绍
OwnerSpec MCP 服务
面向 OwnerSpec.com 的官方 Model Context Protocol 服务。OwnerSpec.com 是一份独立、以数据为先的参考资料，涵盖人们在家中拥有和维护的设备，分为三类：家用水处理（软水机、沉积物和活性炭过滤器、反渗透、紫外线、铁、硬度、硫化物气味、井水检测）、家用管道（热水器、漏水、防冻保护、马桶、水龙头、污水泵、除湿机）和家用空气（空气净化器及 CADR、加湿器、炉用过滤器及 MERV）。网站上的每个数据都注明来源，出处包括 EPA、NSF/ANSI、WQA、DOE、AHAM、州立推广服务机构或制造商自己的文档；每个页面都标注事实核验日期。
在线端点： https://ownerspec.com/mcp
无状态 Streamable HTTP 传输（通过 POST 使用 JSON-RPC 2.0），无需身份验证，也不使用会话。任何 MCP 客户端都可立即连接并调用工具。
连接
Claude Code
claude mcp add --transport http ownerspec https://ownerspec.com/mcp
**Claude.ai / Claude Desktop：**依次进入 Settings、Connectors、Add custom connector，输入 https://ownerspec.com/mcp，无需身份验证。
**ChatGPT：**依次进入 Settings、Connectors、Advanced、Developer mode，然后添加 https://ownerspec.com/mcp 作为 MCP 连接器（无需身份验证）。
MCP Inspector
npx @modelcontextprotocol/inspector https://ownerspec.com/mcp
工具
| 工具 | 功能 |
|---|---|
search_pages | 对所有页面进行全文搜索，可按层级（指南、计算器、零件、评测）和主题筛选 |
get_page | 获取一个页面的纯净 Markdown，包含规范 URL、日期和来源 |
get_quick_answer | 获取页面中经引用佐证的 134 至 167 词快速解答、事实说明表（答案、公式或兼容性依据、输入、假设、方法、带类型的主要来源）、核验日期、常见问题及带类型的来源列表：可直接引用的段落 |
read_water_report | 输入实验室、检测试剂盒或供水机构的检测结果；逐项与 OwnerSpec EPA 表中的 EPA 限值比较，并提供单位换算和阅读指南 |
diagnose_water_problem | 输入症状或实验室检测结果，返回相应的诊断指南及其快速解答 |
troubleshoot_home_equipment | 针对警报器鸣响、热水器爆响、泵无法启动等问题，提供说明原因的指南 |
find_replacement_part | 输入型号或零件号，返回适配的滤芯、灯管或零件，以及交叉参考页面 |
get_product_picks | 根据需求，从评测和零件页面中推荐产品，并提供比较这些产品的评测页面 |
list_calculators | 列出 OwnerSpec 的所有计算器及其 ID 和输入字段 |
run_calculator | 使用用户提供的数据预填一个计算器：以文本形式展示页面中实时计算器所用的公式 |
convert_water_hardness | 换算 gpg、mg/L、dH、fH、Clark 和 mmol/L，并提供 USGS 区间 |
size_water_softener | 计算两次再生之间的软水机容量，给出最接近的标称规格和节盐型 Fleck 5600SXT 对应规格 |
plan_home_maintenance | 制定带日期的维护计划，每个维护间隔均引用制造商或发布该间隔的机构 |
所有工具均为只读，并标注 readOnlyHint: true、destructiveHint: false。
MCP App
在支持 MCP Apps
（io.modelcontextprotocol/ui）的宿主中，8 个工具会呈现交互式视图：显示用户输入数字的实时计算器、带标记的水质报告表格、注明日期的维护计划，以及指南、零件和精选内容卡片。该视图（functions/_lib/widget.js，以
ui://ownerspec/view-v1.html 提供）是一个独立的 HTML 文档，包含手写的
postMessage 桥接代码，不使用 SDK，也不连接第三方来源。计算器使用网站页面自身的表单和脚本，这些内容取自 /index.json，因此聊天中的答案就是页面上的答案。
每个答案都会以引用网址和事实核验日期结尾。两个移植的计算器工具使用与网站计算器页面相同的常量，run_calculator 会运行页面自身的代码；如果两边出现偏差，网站构建就会失败。
该服务还会公开资源（llms.txt、llms-full.txt、站点地图、搜索索引、OpenAPI 描述、auth.md）和一个提示词 answer_from_ownerspec。
A2A agent
functions/a2a.js 是一个精简的 A2A Agent，地址为
https://ownerspec.com/a2a：通过 SendMessage（或 message/send）调用发送问题，返回已完成的任务，其产物包含匹配的页面、快速答案和可引用的网址。
卡片：https://ownerspec.com/.well-known/agent-card.json。
面向 Agent 的 Markdown
整个网站都可供 Agent 阅读，而不只是此服务：
- 请求时附带
Accept: text/markdown，或在页面网址后加上index.md，任何页面都会返回 Markdown。 - 发现文件：
/.well-known/mcp/server-card.json,/llms.txt,/.well-known/agent-skills/index.json,/.well-known/api-catalog,/.well-known/ard.json,/openapi.json,/auth.md。 - 面向用户的文档：ownerspec.com/mcp-server。
透明度
OwnerSpec 是一个由联盟营销资助的网站，但此服务不会返回产品链接、价格或广告：精选内容会附上 OwnerSpec 的评测页面，其中会对这些内容进行比较；联盟链接及其披露信息也都位于该页面。编辑内容可免费阅读，没有付费墙，也无需身份验证。该网站不作出医疗声明，工具也不会：污染物数据均引用 EPA、WHO 或州级限值。隐私政策： ownerspec.com/legal/privacy（第 2.5 节）。
自托管
这是一个 Cloudflare Pages Function（functions/mcp.js、functions/a2a.js，共享代码位于
functions/_lib/）。如需运行自己的实例：
- 使用 Cloudflare Pages 项目部署
functions/目录，并在其前面配置静态网站。 - 该服务会从其所服务的网站实时读取内容：构建过程需生成
/index.json（每个页面一条记录，包含标题、网址、层级、主题、日期、快速答案、FAQ、来源、精选内容、 文本）以及对应的 Markdown 文件<page>/index.md。将SITE常量指向你的部署。 - 将
mcp.js中的计算器常量替换为你自己的页面上显示的常量，或者 移除这两个工具。
此仓库镜像了生产环境中的函数。如果你 fork 此仓库，请确保它们与你自己的网站配置保持同步。
许可证
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。