UnityMCP + Claude + VSCode 搭建 AI 游戏开发工作流

安装 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 未连接或调用失败的情况，可参考以下方案：

1. 检查配置文件：确保 Unity 项目根目录存在 .mcp.json，且 URL 指向正确的 localhost 端口。
2. 环境变量：如果 Python 或 uv 无法正常使用，StartServer 时提示找不到文件，请检查系统环境变量配置是否正确。
3. 引导 AI 排查：如果 Claude 一直检测不到连接，可以直接在对话框询问 AI 为什么没有连接，让它一步步引导你排查原因。
4. 官方文档：参考 MCP 将 Claude Code 连接到工具的官方文档获取最新配置说明。

总结

UnityMCP + Claude + VSCode 的组合，将 AI 的认知能力与 Unity 的创作能力深度融合。无论是独立开发者还是小型团队，都能借助这一环境快速验证想法、减少技术债务，将更多精力聚焦于创意本身。随着 AI 模型的进化与 MCP 生态的完善，这一模式有望成为游戏开发的标准配置。