UnityMCP + Claude + VSCode：搭建 AI 游戏开发环境

为了方便在不同 API Key 之间切换，推荐使用 cc-switch 工具管理模型配置。

2.4 设置 MCP 连接

在 Unity 工程目录下创建一个 .mcp.json 文件，内容如下：

{
  "mcpServers": {
    "unityMCP": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

这一步至关重要，否则 Claude 将无法检测到 UnityMCP 服务。

2.5 实战演示

首次使用时，在 Claude 对话窗口输入 /init，AI 会输出更符合项目背景的功能说明。

可以通过 /mcp 命令检查 MCP server 连接状态。

尝试输入自然语言提示词，例如：Create a red, blue and yellow cube。

或者更具体的中文指令：帮我在 AIScene 中创建一个平面和一个角色，角色支持 WASD 移动，移动速度为 5。

运行后即可看到角色按指定速度进行前后左右移动。至此，UnityMCP + Claude + VSCode 的开发流程已跑通，后续可直接通过对话框让 AI 协助开发游戏功能。

三、常见问题排查

如果在初次使用时遇到 MCP 未连接或调用失败的情况，可参考以下方案：

1. 检查配置文件位置：确保 Unity 项目根目录存在 .mcp.json 文件，且内容格式正确。
2. 全局配置：若所有项目均需使用该工具，可在 VSCode 的全局配置目录（如 C:\Users\Administrator\AppData\Roaming\Code\User）下配置 mcp.json。
3. 引导 AI 排查：若 Claude 仍检测不到连接，可直接询问 AI 为何未连接，让其一步步引导诊断。
4. Python 环境问题：若在 Unity 中点击 StartServer 时提示无法打开文件，请检查 Python 环境变量是否配置正确，或将报错信息发送给 AI 进行诊断。

四、结语

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