prefab-sentinel

tyunta/prefab-sentinel
★ 3 stars Python 🤖 AI/LLM Updated 5d ago
An MCP server specialized for VRChat avatar and world projects: it parses the asset YAML directly — including UdonSharp's split program/behaviour structure — to detect and repair broken references, prefab Variant override drift, and null wiring across prefabs, scenes, and materials. Built for AI agents, every fix runs through a dry-run → confirm ga
View on GitHub →

Quick Install

Copy the config for your editor. Some servers may need additional setup — check the README.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "prefab-sentinel": {
      "command": "uvx",
      "args": [
        "prefab-sentinel"
      ]
    }
  }
}

Or install with pip: pip install prefab-sentinel

README Excerpt

Unity / VRChat プロジェクトの Prefab / Scene / Asset を安全に編集・検査するための MCP サーバー。`Variant` の override 衝突、`Broken PPtr` / missing fileID、Udon / ClientSim ランタイム例外を構造化された応答で診断し、手作業 YAML 編集を経由せずに修復する。AI エージェント前提で設計しており、書き込み系ツールは `confirm=True` + 非空 `change_reason` の監査ペアを必須化している。 84 個の MCP ツール([docs/tools.md](./docs/tools.md) に正本一覧)と 5 つのスキル(`/prefab-sentinel:guide` / `variant-safe-edit` / `prefab-reference-repair` / `udon-log-triage` / `knowledge-acquisition`)を組み合わせて、broken reference の検出と修復、Variant override の可

Tools (20)

BRIDGE_LEGACY_SCHEMA_REJECTEDBROKEN_PPTRCHANGE_REASON_REQUIREDCOMPILE_TIMEOUT_OUT_OF_RANGEEDITOR_CTRL_ADD_COMPONENT_RELINKEDEDITOR_CTRL_ANIMATION_CLIP_APPLY_FAILEDEDITOR_CTRL_BATCH_BLEND_SHAPE_PARSEEDITOR_CTRL_CAMERA_CONFLICTEDITOR_CTRL_CROP_ROI_NO_TARGETEDITOR_CTRL_EDITOR_STATE_OKEDITOR_CTRL_FORCE_REFRESH_FAILEDEDITOR_CTRL_INVALID_CLASSIFICATION_FILTEREDITOR_CTRL_INVALID_CURSOREDITOR_CTRL_INVALID_ORDEREDITOR_CTRL_INVALID_PHASE_FILTEREDITOR_CTRL_MAX_ENTRIES_OUT_OF_RANGEEDITOR_CTRL_PREFAB_STAGE_CLOSE_FAILEDEDITOR_CTRL_RECOMPILE_AND_WAIT_NOOPEDITOR_CTRL_RECOMPILE_FAILEDEDITOR_CTRL_RECOMPILE_SCHEDULE_FAILED