mcp-unity

概述

MCP Unity 是一个全面的模型上下文协议实现，将 Unity 编辑器与 AI 编码助手连接起来。它提供了广泛的工具来操作 Unity 场景、GameObject 属性、组件、材质和包。服务器支持基于工具的操作和基于资源的查询，实现 AI 代理和 Unity 项目之间的双向通信。其 IDE 集成功能通过将 Library/PackedCache 添加到工作区上下文来改进 Unity 包的代码智能。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• execute_menu_item

  Executes Unity menu items (functions tagged with the MenuItem attribute)

  试试:Execute the menu item 'GameObject/Create Empty' to create a new empty GameObject
• select_gameobject

  Selects game objects in the Unity hierarchy by path or instance ID

  试试:Select the Main Camera object in my scene
• update_gameobject

  Updates a GameObject's core properties or creates the GameObject if it does not exist

  试试:Set the Player object's tag to 'Enemy' and make it inactive
• update_component

  Updates component fields on a GameObject or adds it to the GameObject if it does not contain the component

  试试:Add a Rigidbody component to the Player object and set its mass to 5
• add_package

  Installs new packages in the Unity Package Manager

  试试:Add the TextMeshPro package to my project
• run_tests

  Runs tests using the Unity Test Runner

  试试:Run all the EditMode tests in my project
• get_gameobject

  Gets detailed information about a specific GameObject including all components

  试试:Get the details of the Player GameObject
• get_console_logs

  Retrieves logs from the Unity console with pagination support

  试试:Show me the last 20 error logs from the Unity console
• save_scene

  Saves the current active scene, with optional Save As to a new path

  试试:Save the current scene试试:Save the scene as 'Assets/Scenes/Level2.unity'
• duplicate_gameobject

  Duplicates a GameObject in the scene with optional renaming and reparenting

  试试:Duplicate the Enemy prefab 5 times and rename them Enemy_1 through Enemy_5
• move_gameobject

  Moves a GameObject to a new position (local or world space)

  试试:Move the Player object to position (10, 0, 5) in world space
• batch_execute

  Executes multiple tool operations in a single batch request

  试试:Create 10 empty GameObjects named Enemy_1 through Enemy_10 in a single batch operation

可对比工具

安装

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["@codergamester/mcp-unity"],
      "env": {
        "UNITY_PROJECT_PATH": "/path/to/your/unity/project"
      }
    }
  }
}

FAQ

支持哪些 Unity 版本？

MCP Unity 支持 Unity 6 及更高版本。

哪些 IDE 与 MCP Unity 兼容？

它专为支持 MCP 的 Cursor、Claude Code、Codex、Windsurf 和其他类似 VSCode 的 IDE 设计。

mcp-unity 对比