mcpField
O
operandi

operandi

ローカル
github.com/ArchieAngelBeWithUs-progその他014 週間前に更新
リポジトリ

operandi について

OPERANDI は、実機の家電を扱うエージェントやロボットプランナー向けの MCP サーバーです。機種を特定し、その機種に即した手順、確認信号、復旧手順、安全範囲を返します。

主な機能

  1. 01銘板や型番による家電の特定
  2. 02機種別の操作パッケージ取得
  3. 03操作マップと根拠の提示
  4. 04手順ごとの確認信号
  5. 05復旧状態と安全範囲の提示

活用シーン

  1. 01銘板から家電を特定
  2. 02ロボットに根拠のある操作手順を渡す
  3. 03操作中に手順と復旧方法を確認

MCP 対応

MCP クライアントに家電の特定、カタログ参照、機能検索、操作パッケージ取得のツールを公開します。MCP stdio トランスポートを使い、OPERANDI REST サービスと通信します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "cc-operandi-operandi": {
      "command": "uvx",
      "args": [
        "operandi-mcp"
      ],
      "env": {
        "OPERANDI_API_URL": "<OPERANDI_API_URL>",
        "OPERANDI_API_KEY": "<OPERANDI_API_KEY>"
      }
    }
  }
}
起動コマンドuvx operandi-mcp
設定が必要な環境変数
OPERANDI_API_URLBase URL of the OPERANDI API (default https://api.operandi.cc; use your hosted URL in prod).
OPERANDI_API_KEYシークレットOptional: your OPERANDI key. Leave unset for a zero-config instant trial (the server mints + caches its own key, 2 packages included).

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypioperandi-mcp1.0.3

ツール

4

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
brandstringいいえ任意のブランドのヒント（判明している場合）。
limitintegerいいえ一致候補の最大数（1～20、デフォルトは 5）。
querystringはい観測された銘板／モデルのテキスト（例：'Samsung ME20H705MSS'）。
categorystringいいえ任意のカテゴリのヒント。例：'microwave_oven'。
panel_labelsarrayいいえ任意の操作パネルラベルの OCR テキスト（銘板が見えない場合に役立ちます）。

詳細

OPERANDI MCP サーバー — あらゆるエージェントから実際の家電を操作

mcp-name: cc.operandi/operandi

operandi_mcp_server.py は Model Context Protocol を介して OPERANDI を公開するため、MCP 対応の あらゆるエージェントホスト（Claude Desktop、Claude Code、自前のエージェントランタイム）が、家電を特定し、 根拠に基づき、安全性が確認された、ロボットが実行できる操作パッケージを ネイティブツールとして取得できます。

これは「エージェント向けに構築する」ためのインターフェースです。顧客は PDF を読む人間ではなく、 ロボットのプランナー／LLM エージェントです。

ツール

ツール機能
identify_appliance観察された銘板のテキスト／パネルのラベル／モデル名をカタログオブジェクトに照合します（最初に呼び出します）。
get_operation_packageロボットが実行できるパッケージです。モデルに正確に対応した手順、操作マップと根拠付け、ステップごとの検証シグナル、復旧ステートマシン、安全範囲を含みます。
list_appliances操作可能な家電を一覧表示します（カテゴリによる絞り込みも可能です）。
find_by_capability機能（heat／wash／brew／defrost …）から家電を検索します。

エージェントがこれを必要とする理由

一般的なモデルは、事前情報なしでは、日常的な家電について自信満々に誤った操作手順を提示することが少なくありません （OPERANDI Stage A：操作に失敗する指示は 24% で、存在しないボタンやサイクルの捏造も含まれていました）。これらのツールが返す パッケージを根拠にすると、その割合は 幻覚ゼロ、96%が完全一致 まで改善しました。このツールにより、「ボタンを推測する」ことから「メーカーの正確な情報を参照する」ことへと変わります。../docs/BUSINESS_MODEL.md を参照してください。

セットアップ — 設定不要

pip install operandi-mcp

これだけです。最初のパッケージを取得するのにキーは不要です。初回使用時に、サーバーが即時にトライアルキーを自動発行します（POST /v1/trial — サインアップ不要、操作パッケージを2件含み、 ~/.operandi/mcp_key にキャッシュされます）。トライアルを使い切ると、ツールの応答で、無料登録（毎月10件のパッケージ）または Pro へのアップグレード方法がエージェントに正確に通知されます。

すでにキーをお持ちですか？設定するとトライアルキーより優先されます。

export OPERANDI_API_KEY=ok_live_...
Claude Desktop／Claude Code の設定
{
  "mcpServers": {
    "operandi": { "command": "operandi-mcp" }
  }
}

（アカウントキーを取得したら、任意で "env": {"OPERANDI_API_KEY": "ok_live_..."} を追加してください。）

次のようにエージェントに依頼します：「Samsung ME20H705MSS を特定して、ひき肉 0.5 kg を解凍する安全な手順を教えてください。」 — エージェントは identify_appliance、続いて get_operation_package を呼び出し、根拠に基づいたデータから回答します。

注意事項

  • このサーバーは API キーで認証する軽量な REST クライアントです。OPERANDI_API_URL を変更するだけで、同じバイナリをローカル開発環境でもホスト型サービスでも使用できます。
  • 認証方式は Authorization: Bearer <key> です。キーがない場合や無効な場合は、クラッシュせずにツールエラーとして通知されます。
  • トランスポートは改行区切りの JSON-RPC 2.0（MCP の stdio トランスポート）です。オフラインでのプロトコルテスト：pytest tests/test_mcp_server.py。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。