在 Unity 2022.3 及以上版本的编辑器中，打开 Package Manager，选择 "Add from git URL"，粘贴 https://github.com/FunplayAI/funplay-unity-mcp.git 即可完成安装。整个过程由 Unity Package Manager 自动处理依赖解析和编译，无需手动克隆仓库。
项目概览
Funplay Unity MCP 是一个基于 MIT 开源协议的 Unity Editor MCP 服务器，核心能力是让 AI 编码助手直接操作正在运行的 Unity 项目。插件内置 79 个工具，覆盖场景创建、脚本生成、运行时验证、输入模拟、性能分析和编辑器自动化六大场景。工具集分为两个 Profile 级别——core 包含 19 个基础工具，full 包含全部 79 个工具，开发者可按需控制暴露给 AI 的能力范围。
服务器默认监听地址为 http://127.0.0.1:8765/，兼容 Claude Code、Cursor、VS Code Copilot、Windsurf、Codex 等主流 AI 编码工具。安装完成后，上述任意工具即可通过 MCP 协议与 Unity 编辑器通信，执行场景操作、脚本注入和输入模拟等任务。
安装步骤
第一步，确认项目使用 Unity 2022.3 或更高版本编辑器。低于此版本的编辑器不满足插件运行要求。
第二步，在 Unity 编辑器顶部菜单栏依次点击 Window → Package Manager，打开包管理器窗口。
第三步，点击 Package Manager 窗口左上角的 + 按钮，从下拉菜单中选择 Add package from git URL...。
第四步，在弹出的文本输入框中粘贴仓库地址：
https://github.com/FunplayAI/funplay-unity-mcp.git
第五步，点击 Add 确认。UPM 会连接 GitHub 拉取最新版本并自动编译。耗时取决于网络状况，正常情况下十几秒完成。
第六步，安装完成后编辑器顶部菜单栏出现 Funplay 入口。点击 Funplay → MCP Server 启动本地服务器，启动后会在 http://127.0.0.1:8765/ 上监听 AI 工具的连接请求。
第七步，在所使用的 AI 编码工具中配置 MCP 连接地址指向 http://127.0.0.1:8765/。配置完成后，AI 助手即可调用工具操作 Unity 项目。
注意事项与使用限制
插件硬性要求 Unity 2022.3+，低于该版本的项目无法使用，需先升级编辑器。MCP Server 运行时默认占用本机 8765 端口，同时启动多个 Unity 实例可能产生端口冲突。full Profile 暴露全部 79 个工具，其中涉及运行时状态修改和编辑器环境操作，建议在版本控制完善的项目中使用，以便在 AI 执行非预期操作时快速回滚。初次使用建议从 core Profile 的 19 个工具起步，熟悉行为后再切换至 full。此外，UPM 通过 git URL 安装需要网络连接访问 GitHub，网络受限的环境可能需要自建镜像。
相关资源
Funplay 系列覆盖多个引擎，除本文介绍的 Unity 版本外，还提供了 Funplay Godot MCP 等实现，均可在 https://github.com/FunplayAI/ 下找到。更多 AI 辅助游戏开发的技术文章可访问 https://gamebooom.ai/zh/blog/。
meta_title: Unity 2022.3+ 通过 UPM Git URL 安装 Funplay MCP 服务器 meta_description: 在 Unity 2022.3+ 中通过 Package Manager 的 Add from git URL 安装 Funplay Unity MCP，79 个内置工具覆盖场景创建与脚本生成。 primary_keywords: