Hobart Warewash

Hobart 商用洗碗机 MCP

英语 | 法语

一款面向连接到 Hobart SmartConnect 的 Hobart 商用洗碗机（商用洗碗设备） 的 Hobart 洗碗机 MCP 服务。它通过 Hobart Cloud-to-Cloud (C2C) API，Visiotronic 1.5，让 Claude 和 ChatGPT 等 AI 助手能够结构化地访问您的设备：

• 您账户中注册的设备，以及每台设备上次报告的时间
• 当前错误
• 洗涤槽和漂洗温度、上次运行的程序
• 每日用水量、能耗、洗涤剂和漂洗剂消耗量
• 卫生记录：每个洗涤周期一条记录，并注明使用的程序
• 可选：仅在您启用并确认后，注册设备、更改剂量、浓度和自动启动时间

默认情况下，它是只读的。只有设置 HOBART_ALLOW_WRITE=true 后，写入工具才会启用。

非官方。 这是独立的个人项目，与 Hobart 或 ITW Food Equipment Group 无关联，也未获其认可或赞助。您需要自己的 Hobart Cloud-to-Cloud API 凭据。

状态：早期发布版本（0.1.0）。 已在 Hobart AMXXS-B-SEF 设备上针对真实 Hobart C2C API 完成验证。欢迎反馈和设备报告。

为什么要做这个项目？

联网的 Hobart 洗碗机会记录有用的数据（温度、错误、消耗量和每个洗涤周期），但这些数据都在 Hobart SmartConnect 应用中，只能查看，无法直接提问。

这个服务在 Hobart C2C API 与任意 Model Context Protocol 客户端之间搭建了一座小型桥梁。您可以用自然语言提问：“主厨房的洗碗机今天达到漂洗温度了吗？”，助手会调用精准的工具，根据设备数据作答，而不是猜测。

截至 2026 年 11 月，尚无其他公开的 Hobart C2C / SmartConnect API MCP 服务、插件或 SDK（检索范围：MCP 注册目录、GitHub、npm、PyPI）。

功能

• 6 个读取工具，针对人们实际会问的问题设计，其中包括一个一键健康检查工具（hobart_machine_overview）。
• 遵循 Hobart 的轮询限制（错误 30 秒，温度 60 秒）：回答会被缓存，并会注明获取时间以及是否来自缓存，因此助手不会把旧读数误认为实时数据。
• 默认只读，可选择启用写入工具，并要求明确确认。
• 支持本地运行（stdio）和远程运行（Streamable HTTP），可接入 Claude Code、Claude Desktop、claude.ai 和 ChatGPT。
• Claude Code 插件 + Agent Skill（hobart-dishwashers）：帮助模型理解其中的注意事项：离线设备的过时数据、仅在夜间刷新的每日数据，以及未记录的参数代码。
• 为 Hobart OAuth2 登录缓存并刷新令牌；提供清晰且可操作的错误信息（NOT_FOUND、NOT_BIDIRECTIONAL、AUTH_FAILED，……）。

快速开始

1. 保存您的 Hobart 凭据

创建 ~/.config/hobart-warewash-mcp/.env（Windows 上为 %USERPROFILE%\.config\hobart-warewash-mcp\.env）：

[email protected]
HOBART_PASSWORD=your-password
# HOBART_ALLOW_WRITE=true   # only if you want the write tools

设置的环境变量始终优先于此文件。

2. 连接您的 AI 助手

Claude Code：插件（MCP 服务 + 技能）

claude plugin marketplace add christophe77/hobart-warewash-mcp
claude plugin install hobart-warewash@hobart-warewash-mcp

Claude Desktop、Cursor、VS Code、Windsurf、Cline……（本地 stdio）

{
  "mcpServers": {
    "hobart-warewash": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

要在 Claude Desktop / claude.ai 中使用该技能，请将 plugins/hobart-warewash/skills/hobart-dishwashers 压缩为 zip 文件，然后在 Settings → Capabilities → Skills 中上传。

从源代码运行

git clone https://github.com/christophe77/hobart-warewash-mcp.git
cd hobart-warewash-mcp
npm install
npm run build
cp .env.example .env    # fill HOBART_USERNAME and HOBART_PASSWORD
node scripts/smoke.mjs  # calls every read tool against the real API

克隆的项目会依次从当前文件夹、上述用户文件以及项目自身文件夹中读取 .env。

ChatGPT 和 claude.ai（远程连接器）

Web 和移动端助手只接受通过 HTTPS 连接的远程 MCP 服务。运行 HTTP 模式并将其暴露出来，例如使用隧道：

npx -y [email protected] --http         # http://127.0.0.1:3333/mcp
cloudflared tunnel --url http://localhost:3333  # or: ngrok http 3333

连接器 URL：https://<your-host>/mcp/<MCP_HTTP_SECRET>。ChatGPT 和 claude.ai 无法发送自定义标头，因此密钥会放在路径中； Authorization: Bearer <secret> 适用于能够发送自定义标头的客户端。 如果未设置 MCP_HTTP_SECRET，服务端只会在 localhost 上响应。

• ChatGPT：Settings → Apps & Connectors → Advanced → Developer mode → Create；粘贴 URL；身份验证选择“No authentication”。将 plugins/hobart-warewash/skills/hobart-dishwashers/SKILL.md 粘贴到项目指令中， 即可提供相同的领域知识。
• claude.ai：Settings → Connectors → Add custom connector；粘贴 URL。

示例问题

• “列出我的 Hobart 洗碗机，并告诉我哪些设备已经一周没有上报。”
• “洗碗机 867237207 现在正常吗？”
• “上一个周期的洗涤温度和漂洗温度是多少？”
• “昨天每台机器用了多少水和能源？”
• “显示今天的卫生协议：运行了多少个周期，使用了哪些程序？”
• “有没有任何机器存在活动错误？”
• 使用写入模式：“将 867237207 的自动启动时段 1 设为 06:30。”助手会读取当前值，显示旧值 → 新值，并等待你确认。

可用的 MCP 工具

工具	可查询的信息	访问权限
hobart_list_machines	账户下的机器、类型、协议、最后联系时间	读取
hobart_machine_overview	活动错误 + 温度 + 每日消耗，一次调用即可获取	读取
hobart_get_machine_data	所有参数、计数器、卫生协议（周期日志）	读取
hobart_get_active_errors	当前活动错误（缓存 30 秒，受 Hobart 限制）	读取
hobart_get_temperatures	洗涤（A270）/ 漂洗（A283）温度（°C）、上次运行的程序（缓存 60 秒）	读取
hobart_ping	API 是否可访问、账户是否通过验证	读取
hobart_register_machine	使用 6 位代码注册机器	写入
hobart_update_settings	洗涤剂 / 漂洗剂剂量和浓度、自动启动开关及时间	写入

设置对应 Hobart 参数代码：A133 / A134（剂量）、A104 / A105 （浓度）、S078（自动启动）、A180–A186（自动启动时段，HH:MM）。 不支持双向通信的机器会拒绝更改设置 （NOT_BIDIRECTIONAL，HTTP 409）。

配置

变量	默认值	用途
HOBART_USERNAME	（无）	Hobart C2C 账户（必需）
HOBART_PASSWORD	（无）	Hobart C2C 密码（必需）
HOBART_ALLOW_WRITE	false	启用写入工具
PORT / HOST	3333 / 127.0.0.1	HTTP 模式监听地址
MCP_HTTP_SECRET	（无）	用于保护 HTTP 端点的密钥
HOBART_BASE_URL、HOBART_TOKEN_ENDPOINT、HOBART_CLIENT_ID、HOBART_SCOPE	Hobart 生产环境值	覆盖值

常见问题

是否有面向 AI 助手的官方 Hobart MCP 服务或 API？ 据我们所知，没有。Hobart 为合作伙伴提供 Cloud-to-Cloud REST API；本项目将其封装为 MCP 服务。本项目并非官方项目。

支持哪些 Hobart 设备？ 支持 Hobart C2C 账户可查看的任何设备，也就是通过 SmartConnect 连接的 Hobart 洗碗机。已在 AMXXS-B-SEF 上测试。

能与 ChatGPT 配合使用吗？ 可以，通过 HTTP 模式作为远程连接器（开发者模式）使用。 也适用于 Claude（Desktop、Code、claude.ai）和任何 MCP 客户端。

AI 能自行更改设备设置吗？ 不能。写入工具默认关闭；启用后，工具描述和技能都会要求先展示更改内容并征得你的明确同意。Claude 等客户端在调用破坏性工具前也会征求确认。

数据是实时的吗？ 错误和温度数据接近实时（在 Hobart 规定的 30 s / 60 s 时限内）。每日数据仅在设备关机后或午夜前不久刷新。如果设备处于离线状态，设备列表中的最后联系时间会告诉你这些数据有多旧。

它能用于 HACCP 或卫生记录吗？ 它会提供卫生协议（每个洗涤周期一条记录，包含所用程序）和温度数据，助手可以对其进行总结。但它不能替代你的官方 HACCP 记录。

隐私与安全

• 在你的设备（或你自己的服务器）上运行；只连接 Hobart 的官方端点。不收集遥测数据。
• 凭据保存在你的 .env 文件或环境变量中，绝不会出现在工具输出中。
• 所有用户共用一个 Hobart 账户：任何能够访问 HTTP 部署的用户都以该账户身份操作。路径密钥适用于个人使用；多用户部署则需要在前面配置 OAuth。

局限性

• API 不会返回每日消耗量数据的单位，且大多数 A0xx / C0xx 代码没有文档说明：服务会原样返回这些代码，技能会提醒模型不要凭空编造其含义。
• 默认令牌范围为 Machines.Read；是否接受设置写入请求取决于你的账户和设备。

许可证

Apache-2.0

免责声明

这是一个独立的开源项目，与 Hobart 或 ITW Food Equipment Group 无关，也未获其认可或赞助。“Hobart”和“SmartConnect”是其各自所有者的商标，在此仅用于描述兼容性。使用风险由你自行承担；食品安全绝不能依赖 AI 助手。