Unity MCP ✨

您的大型语言模型可以使用以下函数：

• read_console：从控制台获取消息或清空控制台。
• manage_script：管理C#脚本（创建、读取、更新、删除）。
• manage_editor：控制和查询编辑器的状态和设置。
• manage_scene：管理场景（加载、保存、创建、获取层次结构等）。
• manage_asset：执行资产操作（导入、创建、修改、删除等）。
• manage_gameobject：管理游戏对象：创建、修改、删除、查找和组件操作。
• execute_menu_item：通过其路径执行菜单项（例如，“文件/保存项目”）。

• Git CLI： 用于克隆服务器代码。下载Git
• Python： 3.12或更高版本。下载Python
• Unity Hub和编辑器： 2020.3 LTS或更高版本。下载Unity
• uv（Python包管理器）：

  pip install uv
  # 或者查看：https://docs.astral.sh/uv/getting-started/installation/
  

• 一个MCP客户端：
  • Claude Desktop
  • Cursor
  • (其他客户端可能需要手动配置)

Windows：

{
  "mcpServers": {
    "UnityMCP": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\UnityMCP\\UnityMcpServer\\src",
        "server.py"
      ]
    }
    // ... 其他服务器可能在这里 ...
  }
}

（请记住替换YOUR_USERNAME并使用双反斜杠\）

macOS：

{
  "mcpServers": {
    "UnityMCP": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/usr/local/bin/UnityMCP/UnityMcpServer/src",
        "server.py"
      ]
    }
    // ... 其他服务器可能在这里 ...
  }
}

（如果使用~/bin，请替换YOUR_USERNAME）

Linux：

{
  "mcpServers": {
    "UnityMCP": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/home/YOUR_USERNAME/bin/UnityMCP/UnityMcpServer/src",
        "server.py"
      ]
    }
    // ... 其他服务器可能在这里 ...
  }
}

（替换YOUR_USERNAME）

• Unity桥接器未运行/连接：

  • 确保Unity编辑器已打开。

  • 检查状态窗口：窗口 > Unity MCP。

  • 重新启动Unity。

• MCP客户端未连接/服务器未启动：

  • 验证服务器路径： 仔细检查您的MCP客户端JSON配置中的--directory路径。它必须与安装步骤1中克隆UnityMCP仓库的位置完全匹配（例如，.../Programs/UnityMCP/UnityMcpServer/src）。

  • 验证uv： 确保uv已安装并正常工作（pip show uv）。

  • 手动运行： 尝试直接从终端运行服务器以查看错误：# 首先导航到src目录！ cd /path/to/your/UnityMCP/UnityMcpServer/src uv run server.py

  • 权限（macOS/Linux）： 如果您将服务器安装在系统位置（如/usr/local/bin），请确保运行MCP客户端的用户具有执行uv和访问那里文件的权限。安装在~/bin可能更容易。

• 自动配置失败：

  • 使用手动配置步骤。自动配置可能没有权限写入MCP客户端的配置文件。