unity-mcp 是什么？
unity-mcp 是由 CoplayDev 维护的 MCP 项目，用来把设计稿、画布、三维场景或创作软件连接到 Codex 等支持 MCP 的客户端。本站按 GitHub 热度收录，安装方式和可用工具以官方仓库当前 README 为准。
一句话理解unity-mcp 把设计稿、画布、三维场景或创作软件接入 AI 助手，当前 GitHub 热度约 1.3 万 Stars。
为什么需要它？
把设计和创作软件里的对象、属性与操作带回当前任务，减少只看截图猜尺寸、图层或场景状态的偏差。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
读取项目、画布或场景中的结构化对象
把真实信息带回当前任务，减少反复复制和手动核对。
执行项目支持的创建、调整或导出操作
在明确授权范围内调用工具，并保留执行过程和结果。
把软件内的真实状态和结果返回给助手
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 读取设计或场景结构，并在副本里完成一次可回退的小改动
- 需要让编码助手读取真实设计结构、生成可编辑素材，或驱动创作软件完成重复操作的设计与开发人员。
- 返回的对象名称、层级和尺寸能与目标软件中的测试文件逐项对应。
- 不适合第一次调用就覆盖正式设计稿、生产场景或不可恢复的素材。
- 可能读取未公开的设计稿、素材和项目结构
- 写入工具可能直接改变画布、场景或工程文件
怎么接入？
- 1准备
打开官方 GitHub 仓库，找到 Installation、Setup 或 Quick Start。
- 2授权
确认仓库要求的 Node.js、Python、Docker、应用插件或远程端点。
- 3连接
使用本页的 Codex 自助接入指令，让 Codex 先核对 README，再生成并执行准确命令。
- 4开始使用
运行
codex mcp list，并用无敏感测试对象做第一次只读调用。
先核对官方安装说明
该项目的运行时和启动参数可能随版本变化。请让 Codex 先阅读官方 README，再生成适合当前电脑的接入命令。
打开官方仓库检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 unity-mcp
请帮我在当前电脑上接入并验证 unity-mcp。
官方来源：https://github.com/CoplayDev/unity-mcp
目标接入命令：尚未预设。请从官方 README 的 Installation、Setup 或 Quick Start 中确定当前推荐方式。
请按以下步骤执行：
1. 先完整阅读官方 README 的 Installation、Setup 或 Quick Start，找出当前推荐的 MCP 启动方式；不要根据仓库名猜 npm、uvx 或 Docker 包名。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 unity-mcp 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请使用 unity-mcp 连接测试文件，先只读列出当前画布、场景或项目的主要对象和尺寸，不要修改原文件。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。- 复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
- 接入后运行
codex mcp list，再用 unity-mcp 的只读首测任务回读结果。
第一次调用示例
登记完成后，新开一个任务，先用下面这句做只读验证，把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请使用 unity-mcp 连接测试文件，先只读列出当前画布、场景或项目的主要对象和尺寸，不要修改原文件。怎样算成功
返回的对象名称、层级和尺寸能与目标软件中的测试文件逐项对应。
- 先列出 MCP 实际提供的工具或资源。
- 只选择一个测试对象执行无副作用读取。
- 核对对象、来源、时间和目标系统中的真实状态。
- 确认读取范围后，再单独评估写入、删除或发送类工具。
权限与安全
凭证与连接方式
通常需要本地插件、应用端口或项目文件权限；具体连接方式以仓库 README 为准。
- 可能读取未公开的设计稿、素材和项目结构
- 写入工具可能直接改变画布、场景或工程文件
- 首次连接应使用副本，并关闭自动发布或覆盖流程
