Hobart Warewash

Hobart Warewash MCP

英語 | フランス語

Hobart SmartConnect に接続された Hobart 業務用食器洗浄機（食器洗浄機） 向けの Hobart 食器洗浄機 MCP サーバー です。Hobart Cloud-to-Cloud（C2C）API、Visiotronic 1.5 を通じて、Claude や ChatGPT などの AI アシスタントが、以下の情報に構造化された形でアクセスできます。

• アカウントに登録されている機器と、それぞれが最後に報告した時刻
• アクティブなエラー
• 洗浄槽とすすぎの温度、最後に実行したプログラム
• 1 日あたりの水、エネルギー、洗剤、リンス剤の消費量
• 衛生プロトコル：各洗浄サイクルにつき 1 件の記録と、実行したプログラム
• オプション：機器の登録、投入量・濃度・自動起動時刻の変更。有効にした場合に限り、さらに確認後にのみ実行されます。

デフォルトでは読み取り専用です。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 種類を備え、1 回の呼び出しでヘルスチェックできるツール（hobart_machine_overview）など、実際によくある質問に対応します。
• Hobart のポーリング制限（エラーは 30 秒、温度は 60 秒）を遵守します。回答はキャッシュされ、取得時刻とキャッシュ由来かどうかが毎回示されるため、アシスタントが古い測定値を最新のものと取り違えることはありません。
• デフォルトでは読み取り専用で、書き込みツールは明示的な確認を伴うオプトイン方式です。
• ローカル（stdio）とリモート（Streamable HTTP）の両方で動作するため、Claude Code、Claude Desktop、claude.ai、ChatGPT と連携できます。
• Claude Code プラグインとエージェントスキル（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 の食器洗浄機を一覧表示して、1 週間報告がないものを教えてください。」
• 「食器洗浄機 867237207 は現在正常ですか？」
• 「直近のサイクルの洗浄温度とすすぎ温度はいくつでしたか？」
• 「昨日、各機械はどれくらいの水とエネルギーを使用しましたか？」
• 「今日の衛生プロトコルを表示してください。サイクル数と使用したプログラムを教えてください。」
• 「いずれかの機械で現在発生しているエラーはありますか？」
• 書き込みモードの場合：「867237207 の自動起動スロット 1 を 06:30 に設定してください。」アシスタントは現在の値を読み取り、変更前 → 変更後を表示して、確認を待ちます。

利用可能な MCP ツール

ツール	対応する質問	アクセス
hobart_list_machines	アカウント上の機械、種類、プロトコル、最終連絡時刻	読み取り
hobart_machine_overview	アクティブなエラー、温度、1 日の消費量を 1 回の呼び出しで表示	読み取り
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 の本番環境の値	上書き

FAQ

AI アシスタント向けの公式な Hobart MCP サーバーや API はありますか？ 見つけられた範囲ではありません。Hobart はパートナー向けに Cloud-to-Cloud REST API を公開しており、このプロジェクトはそれを MCP サーバーとしてラップしています。非公式のプロジェクトです。

どの Hobart の機器に対応していますか？ SmartConnect に接続された Hobart 製食器洗浄機など、Hobart C2C アカウントで確認できるすべての機器に対応しています。AMXXS-B-SEF でテスト済みです。

ChatGPT で動作しますか？ はい。HTTP モードを使用し、リモートコネクター（開発者モード）として動作します。 Claude（Desktop、Code、claude.ai）や、あらゆる MCP クライアントでも動作します。

AI が独断で機器の設定を変更することはありますか？ いいえ。書き込みツールはデフォルトで無効です。有効にした場合も、ツールの説明とスキルで変更内容を表示し、最初に明示的な同意を得るよう求めています。Claude などのクライアントも、破壊的なツールを呼び出す前に確認を求めます。

データはリアルタイムですか？ エラーと温度はほぼリアルタイムです（Hobart の 30 秒／60 秒の制限内）。日次データは、電源を切った後、または深夜の直前にのみ更新されます。機器がオフラインの場合は、機器一覧に表示される最終接続時刻から、データの経過時間がわかります。

HACCP や衛生記録に役立ちますか？ 衛生プロトコル（洗浄サイクルごとにプログラムとともに記録される項目）と温度を提供するため、アシスタントが要約できます。公式な HACCP 記録の代わりにはなりません。

プライバシーとセキュリティ

• お使いのマシン（またはご自身のサーバー）上で実行され、Hobart の公式エンドポイントとのみ通信します。テレメトリーはありません。
• 認証情報は .env または環境変数に保存され、ツールの出力に含まれることはありません。
• Hobart アカウントは共有されます。HTTP デプロイメントにアクセスできる人は、そのアカウントとして操作できます。個人利用にはパスのシークレットで十分ですが、複数ユーザーでデプロイする場合は、その前段に OAuth が必要です。

制限事項

• API は日次の消費量に単位を返さず、ほとんどの A0xx ／ C0xx コードは文書化されていません。サーバーはコードをそのまま返し、スキルはモデルに意味を捏造しないよう指示します。
• デフォルトのトークンスコープは Machines.Read です。設定の書き込みが受け入れられるかどうかは、アカウントと機器によって異なります。

ライセンス

Apache-2.0

免責事項

これは独立したオープンソースプロジェクトです。Hobart または ITW Food Equipment Group とは提携しておらず、これらから推奨や支援を受けているものでもありません。「Hobart」と「SmartConnect」は各所有者の商標であり、ここでは互換性を説明する目的でのみ使用しています。ご自身の責任でご利用ください。食品の安全を AI アシスタントに決して委ねないでください。