AnkleBreaker-Studio/unity-mcp-server

解決的問題

本專案為 AI 助手（如 Claude、Cursor 和 Windsurf）與 Unity 遊戲引擎之間提供一個全面的橋樑。開發者可直接透過 AI 聊天介面控制 Unity 編輯器與 Unity Hub，無需手動執行重複的編輯器任務、場景設定與專案管理。

工作原理

它實作了 Model Context Protocol (MCP)，作為伺服器將 AI 命令轉換為 Unity 內部的操作。架構由三部分組成：AI 助手、MCP 伺服器（本倉儲）以及一個執行 HTTP API 橋接的配套 Unity 編輯器外掛。伺服器透過 Unity Hub CLI 進行安裝任務，並透過 Unity 外掛進行即時編輯器操作。

適用對象

希望自動化工作流程、快速原型化場景，或使用 AI 作為共同開發夥伴來完成從簡單物件放置到複雜著色器與地形編輯等遊戲開發任務的 Unity 遊戲開發者。

主要亮點

• 龐大的工具集：涵蓋 30 多個類別，超過 330 個工具，包括場景管理、物理、照明、動畫與效能分析。
• 深度整合：支援 Shader Graph、Amplify Shader Editor、NavMesh 烘焙與 Memory Profiler 等高階 Unity 功能。
• 智能工具管理：採用兩階系統（核心工具與進階工具），防止 AI 助手的上下文視窗過載。
• 穩健的連接性：具備多實例發現、埠點容錯與崩潰偵測功能，確保編輯器重啟或編譯期間連接穩定。
• 視覺反饋：可擷取場景與遊戲檢視的截圖，供 AI 視覺檢視其操作結果。