一、UnityMCP+Claude+VSCode，构建 AI 游戏开发环境
1.1 介绍
在使用 UnityMCP 之前需要完成基础环境的安装和配置。以下组件为必须安装项：
- Git CLI：用于克隆服务器代码。
- Python：3.12 或更高版本。
- Unity Hub 及编辑器：2020.3 LTS 或更高版本。
- uv（Python 包管理器）：
pip install uv - 支持 MCP 的 AI 客户端：如 Claude Desktop、Cursor、VSCode 等。
本文重点介绍在 VSCode 中接入 Claude 和 UnityMCP 进行游戏开发的流程。
1.2 使用说明及下载
- GitHub 下载地址：https://github.com/CoplayDev/unity-mcp
除了 CoplayDev UnityMCP 之外，还有其他 UnityMCP 实现可供选择：
| 工具 | 地址 | 介绍 |
|---|---|---|
| unity-mcp | https://github.com/CoplayDev/unity-mcp | star:7.2k，持续更新中 |
| Unity-MCP | https://github.com/IvanMurzak/Unity-MCP | star:1.4k |
| CoderGamester - mcp-unity | https://github.com/CoderGamester/mcp-unity | star:1.5k |
| zoucdr - unity3d-mcp | https://github.com/zoucdr/unity3d-mcp/tree/master | star:44 |
二、VSCode 配置
2.1 连接 UnityMCP
在 Unity 中通过 Window → MCP For Unity 打开相关面板，Client 选择 VSCode 然后点击 Start Server 开启连接。
然后在 VSCode 中会出现一个 MCP 服务器 (unityMCP)，点击启动服务器，查看控制台输出一切正常。
此时与 VSCode 内置的 AI 聊天可以看到 UnityMCP 已连接完成。
如果不打算连接 Claude，此时就可以通过 VSCode 进行 Unity 的 AI 开发了。
2.2 在 VSCode 中添加插件
在 VSCode 中添加 Unity 和 Claude Code For VS Code 插件。
此时在 VSCode 中会出现 Claude 的对话按钮，点击即可打开 Claude AI 对话框。
如果 Claude 没安装的话应该不能使用 Claude 对话，下面简单介绍下 Claude 的安装。
2.3 Claude 安装
# 1. 检测 npm 的版本（需要安装 node.js）
npm -v
# 2. 查看 npm 的全局安装路径（可选）
npm config get prefix
# 3. 返回的 npm 全局安装路径
D:\mywork\node-v23.8.0\node_global
# 4. 修改全局安装路径（可选）
npm config set prefix "D:\npm-global"
# 5. 将 npm 的全局安装路径配置到系统的 PATH 变量
# 6. 执行 npm 命令安装 claude code cli
npm install -g @anthropic-ai/claude-code
# 7. 验证安装
claude --version
claude --help
为了方便地在不同 API Key 之间切换，推荐下载 cc-switch 使用。 github 安装地址：https://github.com/farion1231/cc-switch/releases
安装完成之后，在 cc-switch 中配置好模型即可。
2.4 VSCode MCP 配置
在自己的 Unity 工程目录下创建一个 .mcp.json 文件，文件内容如下：
{"mcpServers":{"unityMCP":{"type":"http", "url":"http://localhost:8080/mcp"}}}
这一步必须创建这个文件，不然 Claude 检测不到 UnityMCP，就没办法使用了。
2.5 使用 Claude 开发功能
第一次使用 Claude 时，在 Claude 对话窗口中先执行 /init，这样 AI 就会输出更符合自己项目的功能。
可以在对话框中输入 /mcp 选择 MCP server 查看 UnityMCP 是否连接正常。
如下图所示即可正常使用：
在对话框中尝试输入这样的提示词：Create a red, blue and yellow cube
或者尝试这样说：帮我在 AIScene 中创建一个平面和一个角色，角色支持 WASD 移动，移动速度为 5
这样角色就创建好了，运行之后按 WASD 就会按指定速度进行前后左右移动。
这样就算跑通了 UnityMCP+Claude+VSCode 开发游戏的整个流程，后面就可以直接在对话框通过自然语言让 AI 来开发游戏了。
而 Claude 强大的地方在于我们可以添加各种 Skill 和 MCP，定制化开发自己的游戏项目。
三、相关问题
在第一次使用时遇到的问题可能是 MCP 和 Claude 的配置问题，导致使用 Claude 对话时没办法正确调用 unityMcp 的功能，可能会显示 MCP 未连接。
- Unity 项目根目录添加 .mcp.json 文件，内容如下所示：
{"mcpServers":{"unityMCP":{"type":"http","url":"http://localhost:8080/mcp"}}}
- 在 vscode 的全局目录
C:\Users\Administrator\AppData\Roaming\Code\User下配置一个 mcp.json 文件，这样所有的项目工程都能读到这个 mcp 工具的配置。
{"mcpServers":{"unityMCP":{"url":"http://localhost:8080/mcp","type":"http"}},"servers":{"unityMCP":{"url":"http://localhost:8080/mcp","type":"http"}}}
-
如果 Claude 一直检测不到 UnityMCP 的连接，可以直接在对话框中跟它对话，问 AI 为什么没有连接，然后一步步引导 AI 去排查原因即可。
-
Claude 关于 MCP 连接的文档。通过 MCP 将 Claude Code 连接到工具：https://code.claude.com/docs/zh-CN/mcp
-
Python 和 uv 没办法正常使用。在 Unity 中点击 StartServer 时不能弹出正确的弹窗，而是提示无法打开指定的文件之类的内容，则需要看下 python 的环境变量有没有配置，或者把报错内容直接发给 AI 进行诊断排查即可。
总结
- UnityMCP + Claude + VSCode 的组合，将 AI 的认知能力与 Unity 的创作能力深度融合，重新定义了游戏开发的效率边界。
- 无论是独立开发者还是小型团队，都能借助这一环境快速验证想法、减少技术债务，将更多精力聚焦于创意本身。
- 未来随着 AI 模型的进化与 MCP 生态的完善，这一模式有望成为游戏开发的标准配置。
