UnityMCP

概述

UnityMCP 是一个全面的框架，通过模型上下文协议将 Unity 编辑器与 AI 助手连接。它采用双架构设计，包含 TypeScript MCP 服务器和 C# Unity 插件，支持 HTTP 直接调用和 MCP 工具集成（如 Claude）。系统包含 UDP 发现功能支持多个 Unity 实例，提供幂等命令处理和可扩展插件架构，允许自定义命令实现。

试试问 AI

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

• unity_listClients

  List available Unity clients connected to MCP

  试试:List all available Unity clients试试:Show me connected Unity editors
• unity_setActiveClient

  Set the active Unity client for subsequent operations

  试试:Set MyProject as the active client试试:Switch to client with ID abc123
• unity_connectToProject

  Connect to a specific Unity project

  试试:Connect to the MyProject Unity session试试:Establish connection to Unity client
• unity_getActiveClient

  Get information about the currently active Unity client

  试试:Which client is currently active?试试:Show details of the active Unity editor
• unity_execute_code

  Execute C# code in the Unity editor using Roslyn

  试试:Execute C# code to find all GameObjects试试:Run script: GameObject.FindObjectsByType<Transform>(FindObjectsSortMode.None).Length
• console_getLogs

  Get console logs from Unity editor

  试试:Show me the Unity console logs试试:Get recent console output
• console_getCount

  Get count of console log messages

  试试:How many console messages are there?试试:Count error messages in console
• console_clear

  Clear the Unity console

  试试:Clear the Unity console试试:Reset console logs
• console_setFilter

  Set filter for console log messages

  试试:Filter console to show only errors试试:Set log filter to warnings only
• menu_execute

  Execute Unity menu commands

  试试:Execute Build menu command试试:Run File > Save Assets
• browse_hierarchy

  Browse Unity scene hierarchy with filters

  试试:Show scene hierarchy试试:List all GameObjects with 'Player' in name
• inspect

  Inspect GameObject and Component properties

  试试:Inspect Main Camera properties试试:Check position of player GameObject

可对比工具

安装

{
  "mcpServers": {
    "unity-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/unity-mcp-ts/build/index.js"]
    }
  }
}

FAQ

如何连接到多个 Unity 编辑器？

使用 27180 端口上的代理端点或指定带有项目名称的目标参数。系统通过 UDP 广播自动发现多个 Unity 实例。

代码执行功能安全吗？

/execute_code 端点可以执行任意 C# 代码。在共享环境中，请在 MCP 设置中禁用它或将监听器限制为本地回环（默认行为）。

UnityMCP 对比