Behavior Runtime MCP

@putervision/behavior-mcp

适用于 AI Agent 的高频（约 60Hz）浏览器内行为树战术运行时引擎

@putervision/behavior-mcp 是一个模型上下文协议（MCP）服务，可直接在浏览器运行时以约 60Hz 执行确定性行为树，并支持响应式触发器抢占、帧录制、SHA-256 Merkle 审计链，以及 5 层安全防护栈。

🌐 官方文档：putervision.com • 交互式网页文档

---

⚡ 15 秒快速入门

# 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 个核心 MCP 工具

工具	操作	用途
load_behavior	load、unload、swap	在浏览器运行时注入、初始化或热交换行为树
set_parameters	set、get、reset	动态更新或查询运行时执行参数
get_status	current、history、tree_state	查询活动状态、节点遍历路径、滴答次数和持续时间
abort_behavior	abort、pause、resume	安全地停止、暂停或恢复行为执行
register_trigger	register、list	配置带优先级抢占的响应式中断触发器
replay_recording	capture、list	捕获或检查确定性的浏览器操作序列
get_metrics	current、history	获取运行时遥测数据、滴答时长和卡滞事件
manage_behaviors	register、get、list	对带有 SHA-256 树哈希的不可变行为树 JSON 执行 CRUD 操作
manage_blackboard	get、set	读取、写入或查询共享行为树黑板变量
manage_runtime_db	stats、audit、snapshot、restore	SQLite 诊断、SHA-256 Merkle 审计和检查点回滚

---

🛡️ 5 层安全防护栈与 System 1 不变量

1. 失败即关闭评估器：无法识别的节点定义会立即抛出致命异常。
2. 60Hz 滴答不变量与同步 semantic_check：循环绝不会因外部网络调用而阻塞；语义条件检查会针对黑板缓存同步解析。
3. HMAC 意图门验证：发送至执行节点的意图必须附带未过期且经过加密签名的派发令牌（PENTAD_HMAC_SECRET）。
4. 操作速率限制器与叶节点策略门：严格限制每秒最多执行 60 次操作，并通过策略防护措施阻止不可逆变更。
5. 紧急终止开关与看门狗心跳：原子安全锁存器和看门狗计时器会在滴答停滞超过 5,000ms 时停止执行。

---

📚 深入文档指南

• 📖 正式 API 参考：完整参数表、类型定义和工具架构。
• 💡 核心架构与概念：行为树执行模型、约 60Hz 循环和触发器生命周期。
• 🖥️ CLI 使用指南：完整的 CLI 命令参考（init、doctor、inspect、run）。
• 💾 数据库架构：SQLite 表结构、索引和 Merkle 审计账本。
• ⚙️ 配置参考：.behavior-mcp.json 参数和环境变量。

---

🔗 客户端配置与环境

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

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

---

🧪 测试

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

---

📄 许可证

MIT © PuterVision