Behavior Runtime MCP

Registre officiel Recherche et web

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que Behavior Runtime MCP ?

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

Comment installer Behavior Runtime MCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add behavior-runtime-mcp -- npx -y @putervision/behavior-mcp@0.4.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Behavior Runtime MCP ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Behavior Runtime MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Behavior Runtime MCP ?

Il est publié par putervision. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.