IvanMurzak/Unity-MCP

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.

解決的問題

Unity MCP 提供了一種將 AI 代理（如 Claude、Cursor 或 Windsurf）直接連接到 Unity 遊戲引擎的方法。它消除了在 LLM 與編輯器之間手動複製程式碼與指令的過程，讓 AI 能夠自動化工作流、生成遊戲機制，並在編輯器與已編譯的遊戲中執行即時除錯。

工作原理

本專案實作了 Model Context Protocol (MCP)，作為 AI 代理與 Unity 之間的橋樑。它提供了一套「工具」（包含 70 多個內建工具），AI 可以呼叫這些工具與 Unity 的 AssetDatabase、Hierarchy、Scene 和 Profiler 進行互動。可以透過 stdio 在本地部署，或透過 HTTP 進行遠端部署。系統可以根據專案特定的 OS、Unity 版本與已安裝的插件自動生成「技能」。

適用對象

希望將 LLM 驅動的自動化整合進開發流程，或直接在執行中的遊戲中實作 AI 驅動行為與除錯工具的 Unity 遊戲開發者。

亮點

  • 編輯器與執行時支援：在 Unity 編輯器內部及已編譯的遊戲建置中運作，實現即時互動。
  • 廣泛的工具集：包含 70 多個用於資產管理、場景操作、腳本編寫與效能分析的內建工具。
  • 代理無關性：相容於包括 Claude、Cursor、GitHub Copilot 與 Gemini 在內的各種 AI 代理。
  • 動態程式碼執行：可以使用 Roslyn 動態編譯並執行 C# 程式碼。
  • 可自訂性：支援在專案程式碼中建立自訂工具與 MCP 提示詞。