Behavior Runtime MCP

@putervision/behavior-mcp

AI エージェント向け、高頻度（約60Hz）のブラウザー内ビヘイビアツリー戦術ランタイムエンジン

@putervision/behavior-mcp は、リアクティブなトリガーによる優先割り込み、フレーム記録、SHA-256 Merkle 監査チェーン、および5層の安全ガードレールスタックを備え、ブラウザーランタイムで決定論的なビヘイビアツリーを約60Hzで直接実行する Model Context Protocol（MCP）サーバーです。

🌐 公式ドキュメント：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. Fail-Closed 評価器：認識されないノード定義は、直ちに致命的な例外をスローします。
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