UnityMCP + Claude + VSCode 搭建 AI 游戏开发工作流
借助 MCP 工具，Claude 可以直接与 Unity 编辑器进行双向指令交互，开发者则可以直接使用自然语言进行 Unity 游戏开发。这一组合充分利用了 AI 的代码生成、问题诊断与创意辅助能力，极大提升了 Unity 项目的开发效率与质量。
环境准备
在开始之前，确保已安装以下基础依赖：
- Git CLI：用于克隆服务器代码。
- Python：3.12 或更高版本。
- Unity Hub 及编辑器：建议 2020.3 LTS 或更高版本。
- uv（Python 包管理器）：可通过
pip install uv安装。 - 支持 MCP 的 AI 客户端：如 Claude Desktop、Cursor 或 VSCode。
目前市面上有多种 UnityMCP 实现可供选择，本文主要基于 CoplayDev 的 unity-mcp 进行演示，其他开源项目如 IvanMurzak/Unity-MCP 等也可参考使用。
| 工具 | 地址 | 介绍 |
|---|---|---|
| unity-mcp (本文使用) | https://github.com/CoplayDev/unity-mcp | Star: 7.2k，持续更新中 |
| Unity-MCP | https://github.com/IvanMurzak/Unity-MCP | Star: 1.4k |
| mcp-unity | https://github.com/CoderGamester/mcp-unity | Star: 1.5k |
VSCode 配置流程
连接 UnityMCP
在 Unity 编辑器中通过 Window → MCP For Unity 打开相关面板，Client 选择 VSCode 然后点击 Start Server 开启连接。启动后，VSCode 控制台应显示 unityMCP 服务正常响应。
此时若查看 VSCode 内置 AI 聊天窗口，应能看到 UnityMCP 已连接完成。如果暂时不接入 Claude，仅使用 VSCode 内置 AI 也能进行基础的 Unity 辅助开发。
安装必要插件
在 VSCode 扩展商店中添加 Unity 和 Claude Code For VS Code 插件。安装完成后，界面会出现 Claude 对话按钮，点击即可打开对话框。
安装 Claude Code CLI
为了在本地运行 Claude 命令，需要安装 Node.js 并全局安装 claude-code CLI。以下是关键步骤：
# 1. 检测 npm 的版本（需先安装 node.js）
npm -v
# 2. 执行 npm 命令安装 claude code cli
npm install -g @anthropic-ai/claude-code
# 3. 验证安装
claude --version
如果遇到网络问题导致安装失败，可尝试调整 npm 镜像地址到国内源。此外，推荐使用 cc-switch 工具来管理不同的 API Key，方便切换模型配置。
配置 MCP 连接
在 Unity 工程目录下创建一个 .mcp.json 文件，内容如下：
{"mcpServers":{"unityMCP":{"type":"http", "url":"http://localhost:8080/mcp"}}}
这一步至关重要，否则 Claude 无法检测到 UnityMCP 服务。如果希望所有项目都能读取该配置，也可以在 VSCode 的全局目录 C:\Users\Administrator\AppData\Roaming\Code\User 下配置一个通用的 mcp.json 文件。
实战开发示例
首次使用 Claude 时，在对话框中执行 /init，AI 会输出更符合当前项目功能的初始化信息。输入 /mcp 可以查看 MCP server 是否连接正常。
确认连接无误后，即可尝试自然语言指令。例如：
Create a red, blue and yellow cube
或者中文指令：
帮我在 AIScene 中创建一个平面和一个角色，角色支持 WASD 移动，移动速度为 5
AI 会自动生成相应的脚本并在场景中创建对象。运行测试后，按 WASD 键即可看到角色按指定速度移动。至此，整个工作流已打通，后续可直接通过对话框让 AI 协助开发游戏功能。
常见问题排查
如果在初次使用时遇到 MCP 未连接或调用失败的情况，可参考以下方案：
- 检查配置文件：确保 Unity 项目根目录存在
.mcp.json，且 URL 指向正确的 localhost 端口。 - 环境变量：如果 Python 或 uv 无法正常使用，StartServer 时提示找不到文件，请检查系统环境变量配置是否正确。
- 引导 AI 排查：如果 Claude 一直检测不到连接，可以直接在对话框询问 AI 为什么没有连接，让它一步步引导你排查原因。
- 官方文档：参考 MCP 将 Claude Code 连接到工具的官方文档获取最新配置说明。
总结
UnityMCP + Claude + VSCode 的组合，将 AI 的认知能力与 Unity 的创作能力深度融合。无论是独立开发者还是小型团队，都能借助这一环境快速验证想法、减少技术债务，将更多精力聚焦于创意本身。随着 AI 模型的进化与 MCP 生态的完善，这一模式有望成为游戏开发的标准配置。