English Français العربية

cc.operandi/operandi

السجل الرسمي الذكاء الاصطناعي والوكلاء

Grounded, safety-checked appliance operation packages for robots and agents. Zero-config trial.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package operandi-mcp
Claude Code 
claude mcp add operandi -e 'OPERANDI_API_URL=https://api.operandi.cc' -e 'OPERANDI_API_KEY=<your operandi_api_key>' -- uvx operandi-mcp==1.0.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "operandi": {
            "command": "uvx",
            "args": [
                "operandi-mcp==1.0.3"
            ],
            "env": {
                "OPERANDI_API_URL": "https://api.operandi.cc",
                "OPERANDI_API_KEY": "<your operandi_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • OPERANDI_API_URL Base 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).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. OPERANDI MCP Server — operate real appliances from any agent
  2. Tools
  3. Why an agent wants this
  4. Setup — zero config
  5. Notes

OPERANDI MCP Server — operate real appliances from any agent

mcp-name: cc.operandi/operandi

operandi_mcp_server.py exposes OPERANDI over the Model Context Protocol so any MCP-capable agent host (Claude Desktop, Claude Code, or your own agent runtime) can identify an appliance and pull its grounded, safety-checked, robot-executable operation package as native tools.

This is the "build for agents" surface: the customer is a robot's planner / an LLM agent, not a human reading PDFs.

Tools

ToolWhat it does
identify_applianceResolve observed nameplate text / panel labels / model → a catalog object (call first).
get_operation_packageThe robot-executable package: model-exact procedures, control map + grounding, per-step verification signals, recovery state machine, safety envelope.
list_appliancesBrowse operable appliances (optionally by category).
find_by_capabilityFind appliances by function (heat / wash / brew / defrost …).

Why an agent wants this

A general model, cold, gives confidently-wrong physical instructions on ordinary appliances a large fraction of the time (OPERANDI Stage A: 24% of cold instructions were would-fail, including invented buttons and cycles). Grounded in the package these tools return, that fell to 0 hallucinations, 96% exact. The tools turn "guess the buttons" into "read the manufacturer's ground truth". See ../docs/BUSINESS_MODEL.md.

Setup — zero config

pip install operandi-mcp

That's it. No key needed for your first packages: on first use the server mints an instant trial key itself (POST /v1/trial — no signup, 2 operation packages included, cached at ~/.operandi/mcp_key). When the trial is spent, tool responses tell the agent exactly how to sign up free (10 packages/month) or go Pro.

Have a key already? Set it and it wins over the trial:

export OPERANDI_API_KEY=ok_live_...
Claude Desktop / Claude Code config
{
  "mcpServers": {
    "operandi": { "command": "operandi-mcp" }
  }
}

(Optionally add "env": {"OPERANDI_API_KEY": "ok_live_..."} once you have an account key.)

Then ask the agent: "Identify the Samsung ME20H705MSS and give me the safe procedure to defrost 0.5 kg of mince." — it will call identify_appliance then get_operation_package and answer from grounded data.

Notes

  • The server is a thin, API-key-authenticated REST client — the same binary works against local dev or the hosted service by changing OPERANDI_API_URL.
  • Auth is Authorization: Bearer <key>; a missing/invalid key surfaces as a tool error, not a crash.
  • Transport is newline-delimited JSON-RPC 2.0 (the MCP stdio transport). Offline protocol tests: pytest tests/test_mcp_server.py.

الأسئلة الشائعة

ما هو cc.operandi/operandi؟

Grounded, safety-checked appliance operation packages for robots and agents. Zero-config trial.

كيف أثبّت cc.operandi/operandi؟

يعمل على جهازك. في Claude Code: claude mcp add operandi -e 'OPERANDI_API_URL=https://api.operandi.cc' -e 'OPERANDI_API_KEY=<your operandi_api_key>' -- uvx operandi-mcp==1.0.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج cc.operandi/operandi إلى مفتاح API؟

نعم. يتطلب OPERANDI_API_KEY، وتضبطها في إعداداته.

هل cc.operandi/operandi مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون cc.operandi/operandi؟

ينشره ArchieAngelBeWithUs-prog. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.