AI驱动 · 模块化 · 高性能

Unity3d MCP
AI驱动的Unity开发工作流

通过MCP协议将AI助手与Unity编辑器无缝连接,
使用自然语言控制Unity,提供32+专业工具,覆盖完整开发流程

32+
专业工具
6
应用场景
100%
开源免费
AI → Unity

核心特性

强大的功能,简单的使用

🤖

AI驱动开发

通过自然语言指令控制Unity编辑器,无需记忆复杂的API和命令

🚀

高性能通信

基于TCP Socket的高效通信机制,支持批量操作,低延迟高吞吐

🧩

模块化架构

30+专业工具,覆盖层级管理、资源编辑、性能分析等全流程

🔌

无缝集成

支持Cursor、Claude等主流AI客户端,无需修改现有工作流

🎯

状态树引擎

基于状态模式的路由系统,灵活的参数验证和类型转换

🛠️

易于扩展

插件化设计,支持自定义工具开发,动态方法调用

系统架构

分层设计,清晰高效

AI客户端层
Cursor Claude Trae
MCP协议层
FastMCP Server Unity Package
通信层
TCP Socket (6400-6405) JSON-RPC
Unity编辑器层
Unity Editor Unity API
工具层
30+专业工具 状态树引擎

双层调用架构

FacadeTools(single_call、batch_call)+ MethodTools(32+专业方法)

智能连接管理

多端口自动发现、连接健康检查、失败端口记录和智能切换

协程支持

支持Unity协程的异步操作,不阻塞主线程,适用于长时间运行任务

实际应用示例

通过自然语言指令完成复杂的Unity开发任务

🔧

智能问题修复

"修复控制台中的所有警告和报错"

AI自动分析控制台日志,识别问题类型,提供修复建议并执行修复操作

console_read code_runner
🎨

程序化网格生成

"创建一个60顶点的圆形雨伞网格,保存到Meshes目录"

使用Python脚本生成复杂3D网格,自动导入Unity并保存为资源文件

python_runner edit_mesh
📦

自动化插件管理

"安装android-logcat插件到Unity"

通过Package Manager自动搜索、下载并安装Unity插件包,无需手动操作

manage_package request_http
📊

代码架构可视化

"分析Scripts目录下的代码,用Matplotlib绘制架构图"

扫描项目代码结构,分析类依赖关系,生成专业的UML架构图

project_search python_runner
🏠

智能场景布置

"基于Prefabs下的美术资源及文档,在场景中布置一个房间"

AI理解资源说明文档,自动选择合适的预制体,按照设计规范摆放场景物体

project_search hierarchy_create edit_gameobject
🎯

规则驱动UI构建

"使用规则文件,在场景中构建UGUI界面"

根据JSON/YAML规则文件自动创建UI层级结构,设置布局和样式

ui_rule_manage ugui_layout
🖼️

自动图集生成

"将LoginView界面引用的图片打包为LoginViewAtlas,保存到Atlas文件夹"

自动收集UI引用的所有Sprite,创建Sprite Atlas并优化纹理打包

hierarchy_search edit_sprite_atlas

扩展应用场景

覆盖游戏开发完整工作流

01
🎨

AI图片生成

集成Stable Diffusion批量生成游戏纹理,自动创建Material并应用

Python Runner AI生成
02
📦

批量爬取资源

从Poly Haven等平台批量下载PBR材质,自动创建完整配置

资源管理 自动化
03
📊

架构图生成

分析Unity项目结构,生成可视化架构图和依赖关系

文档自动化 代码分析
04

性能分析

自动检测Draw Call、高多边形模型,提供优化建议

Code Runner 性能优化
05
🧪

测试数据生成

使用Faker批量生成游戏配置数据,用于压力测试

测试 数据生成
06
🌍

本地化翻译

集成GPT-4批量翻译游戏文本,支持多语言版本生成

AI翻译 国际化

快速开始

四步完成配置,开始AI驱动开发

1

安装Python依赖

# 安装Python依赖
cd server
pip install -r requirements.txt
2

配置Unity Package

// 编辑Unity项目 Packages/manifest.json
// 在dependencies中添加:
{
  "dependencies": {
    "io.uframe.unity3d-mcp": "https://gitee.com/zoucdr/unity3d-mcp.git?path=/unity-package#1.0.4",
    // 其他依赖...
  }
}

// 或者手动导入unity-package目录到Unity项目
3

配置MCP客户端

// Cursor配置 (~/.cursor/mcp.json)
{
  "mcpServers": {
    "unityMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/server",
        "run",
        "server.py"
      ]
    }
  }
}
4

启动并测试

# 启动Unity编辑器
# Unity Package会自动启动TCP服务器

# 启动MCP服务器
cd server
python server.py

# 在AI客户端中测试
"请帮我创建一个Cube对象"

工具生态

32+专业工具,覆盖Unity开发全流程

层级管理

  • hierarchy_create
  • hierarchy_search
  • hierarchy_apply

资源编辑

  • edit_gameobject
  • edit_component
  • edit_material
  • edit_texture
  • edit_mesh

项目管理

  • project_search
  • project_operate
  • manage_package

UI工具

  • ugui_layout
  • ui_rule_manage
  • figma_manage

代码运行

  • code_runner (C#)
  • python_runner

存储管理

  • prefers (偏好设置)
  • source_location (资源定位)

其他工具

  • console_read/write
  • request_http
  • gameplay
  • base_editor