AI Game Developer: MCP Cho Dự Án Unity

Đưa AI Vào Phát Triển Unity

AI Game Developer là một plugin Unity Editor đi kèm một MCP server, kết nối các agent như Claude, Cursor, và Windsurf với scene, asset, và script của một dự án Unity. Nó cài đặt dưới dạng file `.unitypackage` hoặc qua OpenUPM, sau đó expose các API của Unity Editor thành công cụ MCP mà agent có thể gọi trực tiếp, gồm cả một lớp runtime hoạt động được bên trong chính game đã compile.

Tính Năng Chính Và Công Cụ Có Sẵn

• ✓Hơn 70 công cụ MCP có sẵn, chia thành bốn nhóm — Project & Assets, Scene & Hierarchy, Scripting & Editor, và Profiling & Diagnostics — bao phủ từ việc tạo một GameObject đến lấy số liệu memory từ Editor Profiler, tất cả đều dùng được ngay sau khi cài đặt mà không cần cấu hình thêm.
• ✓Công cụ `script-execute` compile và chạy C# ngay lập tức thông qua Roslyn, nhờ vậy agent có thể test một thay đổi trong code mà bạn không cần chuyển qua lại Unity để bấm compile.
• ✓Auto-generate Skills đọc hệ điều hành, phiên bản Unity, và các package đã cài để tuỳ chỉnh những gì agent đã kết nối được cho biết nó có thể làm trong đúng dự án đó.
• ✓Việc chọn agent không bị ràng buộc vào một nhà cung cấp — README liệt kê Anthropic, OpenAI, và Microsoft như những nhà cung cấp có thể thay thế cho nhau, đứng sau bất kỳ client nào bạn kết nối.
• ✓Các gói extension chính thức bao phủ Animation, Cinemachine, Input System, Navigation, ParticleSystem, ProBuilder, Splines, Terrain, Tilemap, và Timeline, cho những hệ thống mà bộ công cụ lõi chưa chạm tới.
• ✓Triển khai linh hoạt qua stdio khi chạy local hoặc HTTP khi chạy từ xa, cấu hình theo từng dự án thay vì cố định vào một kiểu transport duy nhất.

Các Tình Huống Phát Triển Game AI Thực Tế

• •Mô tả một thay đổi trong scene bằng ngôn ngữ tự nhiên — sắp xếp các primitive, tạo hàng loạt object, chỉnh một material — rồi để agent tự gọi các công cụ như `gameobject-create` hoặc `assets-material-create` thay vì bạn phải click qua Hierarchy và Inspector.
• •Hướng agent vào log Console và số liệu Profiler thông qua các công cụ diagnostics để nó đề xuất cách sửa thay vì bạn phải tự lần theo stack trace.
• •Viết một cơ chế gameplay cùng với test EditMode hoặc PlayMode của nó trong cùng một phiên làm việc, dùng `tests-run` để kiểm tra kết quả ngay lập tức.
• •Gắn một LLM vào bản build đã phát hành để tạo hội thoại NPC hoặc debug trong game, phản ứng với những gì người chơi đang thực sự làm, chứ không chỉ những gì diễn ra trong Editor.

Các Bước Cài Đặt Cho Dự Án Unity

Theo README, có hai cách cài đặt. Cách dùng GUI: tải `AI-Game-Dev-Installer.unitypackage` từ GitHub release mới nhất rồi import vào một dự án Unity đang mở — double-click file đó, hoặc dùng Assets/Import Package/Custom Package — hoặc chạy `openupm add com.ivanmurzak.unity.mcp` nếu bạn dùng OpenUPM. Cách dùng CLI, được README đánh dấu là khuyến nghị: `npm install -g unity-mcp-cli`, sau đó `unity-mcp-cli install-plugin ./MyUnityProject`; CLI này còn có thể tự cài Unity và khởi tạo một dự án mới nếu bạn bắt đầu từ con số không. Dù đi theo cách nào cũng có một yêu cầu bắt buộc: đường dẫn dự án Unity không được chứa khoảng trắng, nên `C:/MyProjects/MyProject` dùng được nhưng `C:/My Projects/MyProject` thì không.

Kết Nối Và Cấu Hình AI Agent

Chọn một agent — Claude Code là lựa chọn được README khuyến nghị, bên cạnh GitHub Copilot trong VS Code, Cursor, Windsurf, Claude Desktop, và Antigravity — với một ràng buộc thực sự: agent đó cần hỗ trợ Skills hoặc cập nhật công cụ MCP theo kiểu on-the-fly. Từ đó, mở `Window/AI Game Developer` trong Unity, rồi bấm Auto-generate Skills (cách được khuyến nghị) hoặc Configure MCP; nếu client của bạn không nằm trong danh sách có sẵn, cùng cửa sổ đó sẽ hiện đoạn JSON thô để bạn tự dán vào. CLI cũng đi theo luồng tương tự: `unity-mcp-cli login` chạy luồng OAuth device flow qua trình duyệt tới ai-game.dev và lưu credential cục bộ tại `~/.ai-game-dev/credentials.json`, sau đó `unity-mcp-cli open ./MyUnityProject` sẽ tự kết nối và tạo skill. Đăng ký server thủ công cho một agent chạy qua CLI trông như `claude mcp add ai-game-developer <command>` cho Claude Code hoặc `gemini mcp add ai-game-developer <command>` cho Gemini CLI, với `<command>` được điền từ đường dẫn binary theo từng hệ điều hành mà README liệt kê cho Windows, macOS, và Linux. Mặc định, cấu hình đó nhắm agent tới một endpoint cloud chỉ dành riêng cho dự án đó; các team có thể chia sẻ quyền truy cập bằng một enrollment code truyền vào `install-plugin --enroll`.

Ai Phù Hợp Với AI Game Developer?

AI Game Developer dành cho các developer Unity đã làm việc với một agent hỗ trợ MCP — Claude Code, Cursor, Windsurf, hoặc tương tự — và muốn agent đó tự tạo GameObject, viết script C#, và chạy test thay vì chỉ trò chuyện về code trong một panel bên cạnh. Nó cũng phù hợp với các team đang xây gameplay dựa trên AI, như NPC gọi một LLM ở runtime, vì các công cụ của plugin hoạt động được bên trong một build đã biên dịch chứ không chỉ trong Editor. Bỏ qua nếu team bạn chưa dùng agent nào hỗ trợ MCP, hoặc bạn chưa thoải mái để một agent chỉnh sửa trực tiếp GameObject, script, và asset trong dự án của mình.

Câu Hỏi Thường Gặp Về Unity MCP

Lựa Chọn Thay Thế

Vấn Đề Nó Giải Quyết

Hầu hết các AI coding agent có thể đọc và ghi file, nhưng chúng không có cách nào để thấy hay thao tác những gì đang thực sự chạy bên trong Unity Editor — một hierarchy GameObject, các thuộc tính shader của một material, trạng thái Play Mode hiện tại. Unity-MCP expose những phần nội bộ của Editor và runtime đó thành các công cụ MCP, nên thay vì một developer phải tự tay click qua Hierarchy và Inspector để thực hiện một thay đổi mà agent đã mô tả, agent có thể tự gọi `gameobject-create` hoặc `assets-material-create` và xem kết quả.

Repo liên quan