Server data from the Official MCP Registry
In-browser ~60Hz behavior tree execution engine with reactive triggers and safety guardrails.
About
In-browser ~60Hz behavior tree execution engine with reactive triggers and safety guardrails.
Security Report
The behavior-mcp MCP server is a developer tool for executing behavior trees in browser runtimes with safety guardrails. Code quality is generally good with proper error handling and input validation. However, there are moderate concerns: file system operations lack comprehensive path validation in some areas, the policy gate mechanism is basic and could be bypassed, and rate limiting is enforced but not persistent across restarts. Permissions align well with the stated purpose (file I/O for behavior trees, SQLite database, network-optional for browser integration). Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.
6 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-putervision-behavior-mcp": {
"args": [
"-y",
"@putervision/behavior-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
@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
| Tool | Actions | Purpose |
|---|---|---|
load_behavior | load, unload, swap | Inject, initialize, or hot-swap a behavior tree in browser runtime |
set_parameters | set, get, reset | Dynamically update or query runtime execution parameters |
get_status | current, history, tree_state | Query active status, node traversal path, tick count, duration |
abort_behavior | abort, pause, resume | Halt, pause, or resume behavior execution safely |
register_trigger | register, list | Configure reactive interrupt triggers with priority preemption |
replay_recording | capture, list | Capture or inspect deterministic browser action sequences |
get_metrics | current, history | Retrieve runtime telemetry, tick durations, and stuck events |
manage_behaviors | register, get, list | CRUD for immutable behavior tree JSON with SHA-256 tree hashes |
manage_blackboard | get, set | Read, write, or query shared behavior tree blackboard variables |
manage_runtime_db | stats, audit, snapshot, restore | SQLite diagnostics, SHA-256 Merkle audit, and checkpoint rollback |
🛡️ 5-Layer Safety Guardrail Stack
- Fail-Closed Evaluator: Unrecognized node definitions throw fatal exceptions immediately.
- Watchdog Heartbeat Timer: Halts execution if tick evaluation stalls beyond 5,000ms.
- Action Rate Limiter: Strict 60 actions/sec maximum throughput ceiling.
- Leaf Policy Gate: Blocks irreversible, high-risk mutations (
delete_item,spend_currency). - Emergency Kill Switch: Atomic safety latch (
EmergencySafety.engageKillSwitch()) halts all runtimes.
📚 Deep Documentation Guides
- 📖 Formal API Reference: Full parameter tables, type definitions, and tool schemas.
- 💡 Core Architecture & Concepts: Behavior tree execution model, ~60Hz loop, and trigger lifecycle.
- 🖥️ CLI Usage Guide: Complete CLI command reference (
init,doctor,inspect,run). - 💾 Database Schema: SQLite table structures, indexes, and Merkle audit ledger.
- ⚙️ Configuration Reference:
.behavior-mcp.jsonparameters and environment variables.
🔗 Client Configuration
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"mcpServers": {
"behavior-mcp": {
"command": "behavior-mcp",
"args": ["run"]
}
}
}
🧪 Testing
# Run full unit and integration test suite across 15 test files (87 tests)
npm test
📄 License
MIT © PuterVision
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption