AI导哈

Unity AI控制服务器

Unity MCP Server是一个连接AI代理与Unity引擎的桥梁，允许AI实时查看、创建、修改和控制Unity场景中的一切。

  • by azide1337
  • C#
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 azide1337/Antigravity-unity-mcp-server

使用说明

Unity MCP服务器🎮🤖

用AI控制Unity。

该项目实现了一个模型上下文协议（MCP）服务器，该服务器充当AI代理（如Claude Desktop、Cursor或自定义LLM客户端）和Unity引擎之间的桥梁。

它允许AI 看见, 创建, 修改，以及 控制 Unity场景中的所有内容都是实时的。

🌟 特征

  • 上帝模式控制：创建图元、实例化预制件、设置父对象、旋转、缩放和移动对象。
  • 编辑器和播放模式：两者都适用！在游戏运行或编辑关卡设计时修改场景。
  • 全反射：检查组件、读取字段并动态修改值（int、float、bool、string、Vector3）。
  • 逻辑执行：调用任何组件上的任何公共方法。
  • 标签管理：动态创建和分配标签。
  • 清理工具：删除对象以重置场景。

🛠️ 安装

1.Unity设置(/Assets)

  1. 复制 Assets/Scripts/MCP 将文件夹放入Unity项目中。
  2. 添加 MCPBridge 脚本到场景中的任何游戏对象（或创建一个名为“MCPBridge”的空游戏对象）。
  3. 服务器运行在 http://localhost:8080.

2.运行服务器

选项A：简易方法（Unity编辑器）

  1. 在Unity中，单击 工具>Unity MCP服务器 在顶部菜单中。
  2. 点击绿色 启动服务器 按钮。
  3. 终端窗口将打开，显示服务器日志。

选项B：手动方式（终端）

  1. 导航到 mcp-server 文件夹。
  2. 跑 npm install （仅限第一次）。
  3. 跑 npm start.

3.客户端配置

将服务器添加到MCP客户端配置中（例如。， claude_desktop_config.json). 重要：您需要指向构建的文件。

{
  "mcpServers": {
    "unity": {
      "command": "node",
      "args": ["E:/GAME UNITY/MCP SERVER/mcp-server/dist/index.js"] 
    }
  }
}

（注意：将路径替换为项目的实际绝对路径）

📚 可用工具

工具 说明
create_primitive 生成基本形状（立方体、球体等）
instantiate_prefab 从资源中生成复杂资产
set_object_transform 移动对象（位置）
set_object_rotation 旋转对象（欧拉角）
set_object_scale 调整对象大小
set_parent 组织层次结构
inspect_component 读取脚本的公共变量
edit_component 更改变量值（速度、健康等）
invoke_method 调用函数（Jump（）、Attack（）、Reset（））
add_tag / set_object_tag 管理标签
delete_object 从场景中删除对象

📝 示例提示

  • 创建一个红色立方体并将其放置在（0,5,0）处
  • “建造一座由10个球体堆叠而成的塔。”
  • “检查‘Hero’对象上的PlayerController，并将速度设置为20。”
  • “让‘主摄像头’看起来像‘英雄’。”

⚠️ 需求

  • Unity 2020.3或更高版本（在6000.0.26f1上测试）。
  • Node.js 16+。

相关 MCP