您的大语言模型可以使用以下功能：

• manage_asset: 执行资源操作（导入、创建、修改、删除、搜索等）。
• manage_editor: 控制编辑器状态（播放模式、活动工具、标签、层）。
• manage_gameobject: 管理 GameObject（创建、修改、删除、查找、复制、移动）。
• manage_components: 管理 GameObject 上的组件（添加、移除、设置属性）。
• manage_material: 管理材质（创建、设置属性/颜色、分配给渲染器）。
• manage_prefabs: 预制体操作（打开/关闭 Stage、保存、从 GameObject 创建）。
• manage_scene: 场景管理（加载、保存、创建、获取层级、截图）。
• manage_script: 传统脚本操作（创建、读取、删除）。编辑建议使用 apply_text_edits 或 script_apply_edits。
• manage_scriptable_object: 创建并修改 ScriptableObject 资产。
• manage_shader: Shader CRUD（创建、读取、更新、删除）。
• manage_vfx: VFX 操作（ParticleSystem / LineRenderer / TrailRenderer / VisualEffectGraph 等）。
• batch_execute: ⚡ 推荐 - 批量执行多条命令（10-100x 性能提升）。
• find_gameobjects: 按 name/tag/layer/component/path/id 搜索 GameObject（分页）。
• find_in_file: 使用正则搜索 C# 脚本并返回匹配的行号与片段。
• read_console: 获取或清除 Unity Console 日志。
• refresh_unity: 请求刷新资产数据库，并可选触发编译。
• run_tests: 异步启动测试，返回 job_id。
• get_test_job: 轮询异步测试任务的进度和结果。
• debug_request_context: 返回当前请求上下文（client_id、session_id、meta）。
• execute_custom_tool: 执行由 Unity 注册的项目级自定义工具。
• execute_menu_item: 执行 Unity 编辑器菜单项（例如 "File/Save Project"）。
• set_active_instance: 将后续工具调用路由到特定 Unity 实例（从 unity_instances 获取 Name@hash）。
• apply_text_edits: 使用行/列范围进行精确文本编辑（支持前置条件哈希）。
• script_apply_edits: 结构化 C# 方法/类编辑（insert/replace/delete），边界更安全。
• validate_script: 快速验证（basic/standard），用于捕获语法/结构问题。
• create_script: 在指定项目路径创建新的 C# 脚本。
• delete_script: 通过 URI 或 Assets 相对路径删除 C# 脚本。
• get_sha: 获取 Unity C# 脚本的 SHA256 与元数据（不返回内容）。

您的大语言模型可以检索以下资源：

• custom_tools [mcpforunity://custom-tools]: 列出活动 Unity 项目可用的自定义工具。
• unity_instances [mcpforunity://instances]: 列出所有正在运行的 Unity 编辑器实例及其详细信息。
• menu_items [mcpforunity://menu-items]: Unity 编辑器中所有可用菜单项。
• get_tests [mcpforunity://tests]: Unity 编辑器中所有可用测试（EditMode + PlayMode）。
• get_tests_for_mode [mcpforunity://tests/{mode}]: 指定模式（EditMode 或 PlayMode）的测试列表。
• gameobject_api [mcpforunity://scene/gameobject-api]: GameObject 资源用法说明（先用 find_gameobjects 获取 instance ID）。
• gameobject [mcpforunity://scene/gameobject/{instance_id}]: 读取单个 GameObject 信息（不含完整组件序列化）。
• gameobject_components [mcpforunity://scene/gameobject/{instance_id}/components]: 读取某 GameObject 的全部组件（支持分页，可选包含属性）。
• gameobject_component [mcpforunity://scene/gameobject/{instance_id}/component/{component_name}]: 读取某 GameObject 上指定组件的完整属性。
• editor_active_tool [mcpforunity://editor/active-tool]: 当前活动工具（Move/Rotate/Scale 等）与变换手柄设置。
• editor_prefab_stage [mcpforunity://editor/prefab-stage]: 当前 Prefab Stage 上下文（若未打开则 isOpen=false）。
• editor_selection [mcpforunity://editor/selection]: 编辑器当前选中对象的详细信息。
• editor_state [mcpforunity://editor/state]: 编辑器就绪状态快照（包含建议与 staleness）。
• editor_windows [mcpforunity://editor/windows]: 当前打开的编辑器窗口列表（标题、类型、位置、焦点）。
• project_info [mcpforunity://project/info]: 静态项目信息（根路径、Unity 版本、平台）。
• project_layers [mcpforunity://project/layers]: 项目层（0-31）及名称。
• project_tags [mcpforunity://project/tags]: 项目 Tag 列表。

对于捕获未定义命名空间、类型和方法的严格验证级别：

方法 1：Unity 的 NuGet（推荐）

1. 安装 NuGetForUnity
2. 前往 Window > NuGet Package Manager
3. 搜索 Microsoft.CodeAnalysis，选择版本 4.14.0 并安装包
4. 同时安装包 SQLitePCLRaw.core 和 SQLitePCLRaw.bundle_e_sqlite3。
5. 前往 Player Settings > Scripting Define Symbols
6. 添加 USE_ROSLYN
7. 重启 Unity

方法 2：手动 DLL 安装

1. 从 NuGet 下载 Microsoft.CodeAnalysis.CSharp.dll 和依赖项
2. 将 DLL 放置在 Assets/Plugins/ 文件夹中
3. 确保 .NET 兼容性设置正确
4. 将 USE_ROSLYN 添加到脚本定义符号
5. 重启 Unity

注意： 没有 Roslyn 时，脚本验证会回退到基本结构检查。Roslyn 启用完整的 C# 编译器诊断和精确错误报告。

• VSCode：使用 Code/User/mcp.json 和顶级 servers.unityMCP、"type": "http" 以及步骤 2 中的 URL。在 Windows 上，当您切换回 stdio 时，MCP for Unity 仍然偏好绝对 uv.exe 路径。
• Cursor / Windsurf (帮助链接)：如果缺少 uv，MCP for Unity 窗口会显示"uv Not Found"和快速 [HELP] 链接以及"Choose uv Install Location"按钮。
• Claude Code (帮助链接)：如果找不到 claude，窗口会显示"Claude Not Found"和 [HELP] 以及"Choose Claude Location"按钮。注销现在会立即更新 UI。

Claude Code

如果您正在使用 Claude Code，您可以使用以下命令注册 MCP 服务器：

macOS：

claude mcp add --scope user UnityMCP -- uv --directory /Users/USERNAME/Library/AppSupport/UnityMCP/UnityMcpServer/src run server.py

Windows：

claude mcp add --scope user UnityMCP -- "C:/Users/USERNAME/AppData/Local/Microsoft/WinGet/Links/uv.exe" --directory "C:/Users/USERNAME/AppData/Local/UnityMCP/UnityMcpServer/src" run server.py

VSCode（所有操作系统 – HTTP 默认）

{
  "servers": {
    "unityMCP": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

macOS / Windows / Linux（Claude Desktop、Cursor、Claude Code、Windsurf 等 – HTTP 默认）

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

将 URL 设置为与您在 Unity 窗口中输入的内容匹配（包括 /mcp）。

Stdio 配置示例（传统 / 可选）

将 Unity 传输下拉菜单切换到 Stdio，然后使用以下 command/args 块之一。

VSCode（stdio）

{
  "servers": {
    "unityMCP": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "<ABSOLUTE_PATH_TO>/UnityMcpServer/src",
        "run",
        "server.py",
        "--transport",
        "stdio"
      ]
    }
  }
}

macOS / Linux（stdio）

{
  "mcpServers": {
    "unityMCP": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/YOUR_USERNAME/Library/AppSupport/UnityMCP/UnityMcpServer/src",
        "server.py",
        "--transport",
        "stdio"
      ]
    }
  }
}

Windows（stdio）

{
  "mcpServers": {
    "unityMCP": {
      "command": "C:/Users/YOUR_USERNAME/AppData/Local/Microsoft/WinGet/Links/uv.exe",
      "args": [
        "run",
        "--directory",
        "C:/Users/YOUR_USERNAME/AppData/Local/UnityMCP/UnityMcpServer/src",
        "server.py",
        "--transport",
        "stdio"
      ]
    }
  }
}

根据您的平台需要替换 YOUR_USERNAME 和 AppSupport 路径段。

• Unity Bridge 未运行/连接：
  • 确保 Unity 编辑器已打开。
  • 检查状态窗口：Window > MCP for Unity。
  • 重启 Unity。
• MCP 客户端未连接/服务器未启动：
  • 确保本地 HTTP 服务器正在运行（Window > MCP for Unity > Start Server）。保持生成的终端窗口打开。
  • 验证服务器路径： 双重检查您的 MCP 客户端 JSON 配置中的 --directory 路径。它必须完全匹配安装位置：
    • Windows： %USERPROFILE%\AppData\Local\UnityMCP\UnityMcpServer\src
    • macOS： ~/Library/AppSupport/UnityMCP/UnityMcpServer\src
    • Linux： ~/.local/share/UnityMCP/UnityMcpServer\src
  • 验证 uv： 确保 uv 已安装并正常工作（uv --version）。
  • 手动运行： 尝试直接从终端运行服务器以查看错误：

    cd /path/to/your/UnityMCP/UnityMcpServer/src
    uv run server.py

• 配置失败：
  • 使用手动配置步骤。插件可能缺乏写入 MCP 客户端配置文件的权限。