English Français العربية

Behavior Runtime MCP

السجل الرسمي البحث والويب

In-browser ~60Hz behavior tree execution engine with reactive triggers and blackboard projection.

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

التثبيت

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

NPM package @putervision/behavior-mcp
Claude Code 
claude mcp add behavior-runtime-mcp -- npx -y @putervision/behavior-mcp@0.4.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "behavior-runtime-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@putervision/behavior-mcp@0.4.1"
            ]
        }
    }
}

التوثيق

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

المحتويات
  1. @putervision/behavior-mcp
  2. ⚡ 15-Second Quick Start
  3. 🛠️ 10 Core MCP Tools
  4. 🛡️ 5-Layer Safety Guardrail Stack & System 1 Invariants
  5. 📚 Deep Documentation Guides
  6. 🔗 Client Configuration & Environment
  7. 🧪 Testing
  8. 📄 License

@putervision/behavior-mcp

High-Frequency (~60Hz) In-Browser Behavior Tree Tactical Runtime Engine for AI Agents

@putervision/behavior-mcp is a Model Context Protocol (MCP) server that executes deterministic behavior trees directly in browser runtimes at ~60Hz with reactive trigger preemption, frame recordings, SHA-256 Merkle audit chains, and a 5-layer safety guardrail stack.

🌐 Official Documentation: putervision.com • Interactive Web Docs

⚡ 15-Second Quick Start

# 1. Initialize runtime & seed default behavior trees in your workspace
npx @putervision/behavior-mcp init

# 2. Run system diagnostic and health checks
npx @putervision/behavior-mcp doctor

# 3. Inspect active executions, blackboard state, and reactive triggers
npx @putervision/behavior-mcp inspect

🛠️ 10 Core MCP Tools

ToolActionsPurpose
load_behaviorload, unload, swapInject, initialize, or hot-swap a behavior tree in browser runtime
set_parametersset, get, resetDynamically update or query runtime execution parameters
get_statuscurrent, history, tree_stateQuery active status, node traversal path, tick count, duration
abort_behaviorabort, pause, resumeHalt, pause, or resume behavior execution safely
register_triggerregister, listConfigure reactive interrupt triggers with priority preemption
replay_recordingcapture, listCapture or inspect deterministic browser action sequences
get_metricscurrent, historyRetrieve runtime telemetry, tick durations, and stuck events
manage_behaviorsregister, get, listCRUD for immutable behavior tree JSON with SHA-256 tree hashes
manage_blackboardget, setRead, write, or query shared behavior tree blackboard variables
manage_runtime_dbstats, audit, snapshot, restoreSQLite diagnostics, SHA-256 Merkle audit, and checkpoint rollback

🛡️ 5-Layer Safety Guardrail Stack & System 1 Invariants

  1. Fail-Closed Evaluator: Unrecognized node definitions throw fatal exceptions immediately.
  2. 60Hz Tick Invariant & Synchronous semantic_check: The loop never blocks on external network calls; semantic condition checks resolve synchronously against blackboard caches.
  3. HMAC Intention Gate Verification: Intentions dispatched to execution nodes require unexpired, cryptographically signed dispatch tokens (PENTAD_HMAC_SECRET).
  4. Action Rate Limiter & Leaf Policy Gate: Strict 60 actions/sec maximum throughput ceiling and policy guardrails blocking irreversible mutations.
  5. Emergency Kill Switch & Watchdog Heartbeat: Atomic safety latch and watchdog timers halting execution if tick stalls beyond 5,000ms.

📚 Deep Documentation Guides

🔗 Client Configuration & Environment

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "mcpServers": {
    "behavior-mcp": {
      "command": "behavior-mcp",
      "args": ["run"],
      "env": {
        "PENTAD_HMAC_SECRET": "your-secure-shared-secret-here"
      }
    }
  }
}

🧪 Testing

# Run full unit and integration test suite across 38 test files (266 tests)
npm test

📄 License

MIT © PuterVision

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

ما هو Behavior Runtime MCP؟

In-browser ~60Hz behavior tree execution engine with reactive triggers and blackboard projection.

كيف أثبّت Behavior Runtime MCP؟

يعمل على جهازك. في Claude Code: claude mcp add behavior-runtime-mcp -- npx -y @putervision/behavior-mcp@0.4.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Behavior Runtime MCP إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Behavior Runtime MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Behavior Runtime MCP؟

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

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