使用说明

🌉 DevBridge

最强大的AI到Unity的桥梁

用人工智能改变你的Unity开发。在几分钟内创建完整的游戏、系统和功能。

🚀 安装 • ⚡ 快速开始 • 🛠️ 所有工具 • 💡 例子

🎯 为什么选择DevBridge？

DevBridge不仅仅是另一个Unity插件。它是 AI与游戏开发之间的桥梁 --为Claude、Cursor和VS Code Copilot等AI助手提供支持 直接控制 Unity编辑器。

AI可以用DevBridge做什么？

没有DevBridge	有DevBridge
AI写代码，你复制粘贴	AI 直接创建游戏对象、脚本、预制件
手动场景设置	AI 构建整个场景物理、照明、导航
UI创建时间	AI 生成完整的用户界面带画布、按钮、布局
繁琐的资产配置	AI 处理材质、纹理、音频自动
手动构建平台	AI 切换平台、配置构建、导出

💡 基于 MCP for Unity --扩展至 35+专用工具 完成游戏开发。

🚀 安装

先决条件

在安装DevBridge之前，请确保您已经：

需求	版本	安装
统一	2021.3 LTS或更新版本	下载Unity Hub
python	3.10+	下载Python
紫外线	最新	见下文
MCP客户端	任何	克劳德桌面/光标/VS代码

安装uv（Python包管理器）

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

第一步：安装Unity软件包

打开Unity项目，然后：

首选 窗口→ 包管理器
点击 + 按钮（左上角）
选择 “从git URL添加包…”
粘贴此URL：

https://github.com/cnrgrsc/unity-mcp.git?path=/MCPForUnity#beta

点击添加等待安装

✅ 该包将在您的包管理器中显示为“DevBridge”

步骤2：配置您的AI客户端

适用于克劳德桌面

在Unity中： 窗口→ DevBridge
点击 “启动服务器”
选择 “克劳德桌面” 从下拉列表中
点击 “配置” --这将自动更新您的Claude配置
重新启动克劳德桌面
寻找🟢 连接✓ 团结一致

用于光标/VS代码

在Unity中： 窗口→ DevBridge
点击 “启动服务器”
从下拉列表中选择编辑器
点击 “复制配置” 获取MCP配置
添加到编辑器的MCP设置
重新启动编辑器

手动配置

如果自动设置不起作用，请将此添加到MCP配置中：

{
  "mcpServers": {
    "devbridge": {
      "command": "uvx",
      "args": ["devbridge"]
    }
  }
}

配置文件位置：

克劳德桌面（Windows）： %APPDATA%\Claude\claude_desktop_config.json
克劳德桌面（macOS）： ~/Library/Application Support/Claude/claude_desktop_config.json
光标： .cursor/mcp.json 在您的项目中
VS代码： 检查MCP扩展设置

步骤3：验证连接

打开你的AI助手
您应该看到DevBridge工具可用
尝试： “列出场景中的所有游戏对象”
如果它有效，你就连接了！ 🎉

⚡ 快速开始

连接后，用你的AI尝试以下命令：

"Create a Player GameObject with Rigidbody and CapsuleCollider"
"Add a NavMeshAgent to Enemy and set speed to 5"
"Create a Canvas with a Start Button and Quit Button"
"Set up point lights around the scene for atmospheric lighting"
"Build the game for Windows"

🛠️ 完整的工具参考

DevBridge提供 35+专用工具 按类别组织：

🎮 核心游戏对象

工具	操作	描述
`manage_gameobject`	创建、删除、复制、查找、修改	完整游戏对象生命周期
`manage_scene`	打开、保存、创建、列出、获取层次结构	场景管理
`manage_prefabs`	创建、实例化、应用、解包	预制工作流
`manage_components`	添加、删除、获取、设置、列表	组件操作
`find_gameobjects`	by_name、by_tag、by_layer、by_component	高级搜索

⚡ 物理系统

工具	操作	描述
`manage_physics`	rigidbody_add、collider_add、joint_add、光线投射	完成3D物理
`manage_2d`	rigidbody2d_add、collider2d_add、tilemap_create	2D游戏物理

🗺️ 导航与人工智能

工具	操作	描述
`manage_navigation`	bake_navmesh、agent_add、obstacle_add、set_destination	navmesh和寻路

🎨 图形与渲染

工具	操作	描述
`manage_material`	创建、分配、set_property、set_shader	材质控制
`manage_texture`	导入、配置、设置设置	纹理管理
`manage_lighting`	light_create、ambient_set、fog_set、bake	照明系统
`manage_terrain`	创建、雕刻、绘制纹理、添加树木	地形工具
`manage_shader`	创建、修改、获取属性	着色器访问
`manage_vfx`	create_particle、配置、播放、停止	粒子效果

🎬 动画与电影

工具	操作	描述
`manage_animation`	create_controller、add_clip、set_parameter	动画系统
`manage_cinemachine`	vcam_create、set_follow、set_lookat⚠️	虚拟摄像头
`manage_timeline`	创建、添加跟踪、播放⚠️	过场动画和序列

🔊 组合音响

工具	操作	描述
`manage_audio`	source_add、clip_play、mixer_create、3d_configure	完整音频

🎮 输入系统

工具	操作	描述
`manage_input`	action_map_create、binding_add、schema_create	新建输入系统

🖥️ UI系统

工具	操作	描述
`manage_ui`	canvas_create、button_add、text_add、layout	完整的UI工具包

📝 脚本编写

工具	操作	描述
`manage_script`	创建、修改、add_method、add_field	C#代码生成
`manage_scriptable_object`	create、set_field、list	脚本对象支持

🔨 专业工具

工具	操作	描述
`manage_probuilder`	创建形状、拉伸、斜面⚠️	三维建模
`manage_build`	set_platform、add_scene、execute、android_set_settings、ios_set_sets	构建和部署
`manage_localization`	locale_add、table_create、entry_add⚠️	多语言

💰 货币化和分析

工具	操作	描述
`manage_ads`	ads_initialize、show_banner、show_rewarded、iap_add_product	Unity广告、AdMob、iap
`manage_analytics`	send_event、set_user_property、firebase_log_event	分析跟踪

🌐 多人游戏和云

工具	操作	描述
`manage_multiplayer`	setup_network_manager、add_network_object、create_rpc、create_lobby	网络代码和大厅
`manage_cloud`	auth_sign_in、save_data、load_data、config_rech	云保存、身份验证、远程配置

🤖 人工智能与资产

工具	操作	描述
`manage_addressables`	mark_addressable、create_group、build_content、load_asset	资产包
`manage_mlagents`	add_agent、configure_behavior、add_sensor、create_training_config	ML代理AI
`manage_vcs`	git_status、git_comit、git_push、generate_gitignore	git集成

🛠️ 编辑器实用程序

工具	操作	描述
`manage_editor`	selection_get、焦点、首选项	编辑器控件
`manage_asset`	导入、移动、重命名、删除	资产管理
`read_console`	get_log、clear、filter	控制台访问
`refresh_unity`	refresh_assets，重新编译	强制刷新
`run_tests`	run_all，run_category	测试运行器
`batch_execute`	execute_multiple	批处理操作

⚠️ = 需要可选的Unity软件包。看可选包.

💡 使用示例

创建完整的玩家控制器

"Create a Player GameObject at origin with:
- Rigidbody (mass 1, drag 0.5, freeze rotation X and Z)
- CapsuleCollider (height 2, radius 0.5)
- A new C# script called PlayerController with movement using Input System"

构建UI菜单

"Create a main menu UI with:
- Canvas using Screen Space Overlay
- Title text saying 'My Game' at the top
- Start Game button in the center
- Settings and Quit buttons below
- All buttons with hover effects"

设置场景照明

"Set up lighting for an indoor scene:
- Ambient color to warm orange (#FFE4C4)
- Main directional light at 45 degrees, soft shadows
- 4 point lights at corners with blue tint
- Enable fog with exponential falloff"

配置构建设置

"Prepare the game for Android release:
- Switch platform to Android
- Set package name to com.mycompany.mygame
- Set version to 1.0.0
- Add all scenes from Assets/Scenes to build
- Enable development build with debugging"

创建导航系统

"Set up navigation for the level:
- Bake NavMesh for all static geometry
- Add NavMeshAgent to all Enemy objects
- Set Enemy speed to 4, acceleration to 8
- Add NavMeshObstacle to all Barrel prefabs"

📦 可选包

某些工具需要额外的Unity软件包。通过包管理器安装：

功能	包	安装	脚本定义
ProBuilder	`com.unity.probuilder`	包管理器	`PROBUILDER_ENABLED`
电影机器	`com.unity.cinemachine`	包管理器	`CINEMACHINE_ENABLED`
时间线	`com.unity.timeline`	包管理器	`TIMELINE_ENABLED`
本地化	`com.unity.localization`	包管理器	`LOCALIZATION_ENABLED`

要添加脚本，请定义：

首选 Edit → 项目设置→ 玩家
找到 脚本定义符号
添加所需的定义（例如。， CINEMACHINE_ENABLED)
点击应用

🏗️ 建筑

┌──────────────────────────────────────────────────────────────┐
│                        AI Assistant                          │
│              (Claude / Cursor / VS Code / Gemini)            │
└─────────────────────────┬────────────────────────────────────┘
                          │ MCP Protocol (stdio)
                          ▼
┌──────────────────────────────────────────────────────────────┐
│                     DevBridge Server                          │
│                    (Python + FastMCP)                         │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐            │
│  │ 28+ Tools   │ │  Transport  │ │   Router    │            │
│  └─────────────┘ └─────────────┘ └─────────────┘            │
└─────────────────────────┬────────────────────────────────────┘
                          │ HTTP (localhost:5010)
                          ▼
┌──────────────────────────────────────────────────────────────┐
│                      Unity Editor                             │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐            │
│  │  Handlers   │ │  Registry   │ │  Executor   │            │
│  └─────────────┘ └─────────────┘ └─────────────┘            │
└──────────────────────────────────────────────────────────────┘

🔧 故障排除

服务器无法启动

确保已安装Python 3.10+： python --version
确保安装了紫外线： uv --version
检查Unity控制台是否有错误

AI看不到DevBridge工具

配置后重新启动AI客户端
检查服务器是否显示🟢 在Unity中连接
验证MCP配置文件语法

命令失败

确保Unity编辑器处于焦点/活动状态
检查Unity控制台以了解详细错误
确保为可选工具安装了所需的软件包

🤝 贡献

我们欢迎捐款！方法如下：

分叉存储库
创建特征分支： git checkout -b feature/amazing-feature
提交您的更改： git commit -m 'Add amazing feature'
推转到GitHub： git push origin feature/amazing-feature
打开拉取请求

开发设置

# Clone the repo
git clone https://github.com/cnrgrsc/unity-mcp.git

# Navigate to server
cd unity-mcp/Server

# Install dependencies
uv sync

# Run server locally
uv run devbridge

📄 许可证

该项目根据 MIT许可证 --看看许可证文件以获取详细信息。

⭐ 明星这个项目！

如果DevBridge有助于你的Unity开发，请考虑给它一颗星！

由...制作❤️ 面向全球Unity开发者