unity-mcp-cli 0.55.1 → 0.57.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/README.md +110 -42
  2. package/bin/unity-mcp-cli.js +0 -0
  3. package/dist/commands/run-system-tool.d.ts +2 -0
  4. package/dist/commands/run-system-tool.js +132 -0
  5. package/dist/commands/run-system-tool.js.map +1 -0
  6. package/dist/commands/run-tool.js +36 -84
  7. package/dist/commands/run-tool.js.map +1 -1
  8. package/dist/commands/setup-mcp.d.ts +2 -0
  9. package/dist/commands/setup-mcp.js +119 -0
  10. package/dist/commands/setup-mcp.js.map +1 -0
  11. package/dist/commands/setup-skills.d.ts +2 -0
  12. package/dist/commands/setup-skills.js +113 -0
  13. package/dist/commands/setup-skills.js.map +1 -0
  14. package/dist/index.js +6 -0
  15. package/dist/index.js.map +1 -1
  16. package/dist/utils/agents.d.ts +22 -0
  17. package/dist/utils/agents.js +546 -0
  18. package/dist/utils/agents.js.map +1 -0
  19. package/dist/utils/config.d.ts +4 -3
  20. package/dist/utils/config.js +5 -8
  21. package/dist/utils/config.js.map +1 -1
  22. package/dist/utils/connection.d.ts +34 -0
  23. package/dist/utils/connection.js +77 -0
  24. package/dist/utils/connection.js.map +1 -0
  25. package/dist/utils/input.d.ts +13 -0
  26. package/dist/utils/input.js +72 -0
  27. package/dist/utils/input.js.map +1 -0
  28. package/dist/utils/json-parse.d.ts +36 -0
  29. package/dist/utils/json-parse.js +103 -0
  30. package/dist/utils/json-parse.js.map +1 -0
  31. package/dist/utils/port.d.ts +1 -1
  32. package/dist/utils/port.js +3 -3
  33. package/dist/utils/unity-editor.d.ts +9 -0
  34. package/dist/utils/unity-editor.js +23 -6
  35. package/dist/utils/unity-editor.js.map +1 -1
  36. package/dist/utils/unity-hub.d.ts +9 -0
  37. package/dist/utils/unity-hub.js +25 -7
  38. package/dist/utils/unity-hub.js.map +1 -1
  39. package/docs/README.es.md +208 -100
  40. package/docs/README.ja.md +206 -98
  41. package/docs/README.zh-CN.md +205 -97
  42. package/package.json +13 -5
@@ -20,7 +20,7 @@
20
20
  <a href="https://visualstudio.microsoft.com/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/visual-studio-64.png" alt="Visual Studio" title="Visual Studio" height="36"></a>&nbsp;&nbsp;
21
21
  <a href="https://github.com/anthropics/claude-code"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/open-code-64.png" alt="Open Code" title="Open Code" height="36"></a>&nbsp;&nbsp;
22
22
  <a href="https://github.com/cline/cline"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/cline-64.png" alt="Cline" title="Cline" height="36"></a>&nbsp;&nbsp;
23
- <a href="https://github.com/kilocode/kilo-code"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/kilo-code-64.png" alt="Kilo Code" title="Kilo Code" height="36"></a>
23
+ <a href="https://github.com/Kilo-Org/kilocode"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/kilo-code-64.png" alt="Kilo Code" title="Kilo Code" height="36"></a>
24
24
  </p>
25
25
 
26
26
  </div>
@@ -36,44 +36,57 @@
36
36
  - :white_check_mark: **安装插件** — 将 Unity-MCP 插件连同所有必要的作用域注册表添加到 `manifest.json`
37
37
  - :white_check_mark: **移除插件** — 从 `manifest.json` 中移除 Unity-MCP 插件
38
38
  - :white_check_mark: **配置** — 启用/禁用 MCP 工具、提示词和资源
39
- - :white_check_mark: **连接** — 携带 MCP 环境变量启动 Unity,实现自动化服务器连接
39
+ - :white_check_mark: **运行工具** — 直接从命令行执行 MCP 工具
40
+ - :white_check_mark: **设置 MCP** — 为 14 种支持的 AI 代理写入 MCP 配置文件
41
+ - :white_check_mark: **设置技能** — 通过 MCP 服务器为 AI 代理生成技能文件
42
+ - :white_check_mark: **打开并连接** — 启动 Unity,可选携带 MCP 环境变量实现自动化服务器连接
40
43
  - :white_check_mark: **跨平台** — 支持 Windows、macOS 和 Linux
44
+ - :white_check_mark: **CI 友好** — 自动检测非交互式终端,禁用加载动画和颜色输出
45
+ - :white_check_mark: **详细模式** — 对任何命令使用 `--verbose` 获取详细诊断输出
41
46
  - :white_check_mark: **版本感知** — 从不降级插件版本,自动从 OpenUPM 解析最新版本
42
47
 
43
48
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
44
49
 
45
50
  # 快速开始
46
51
 
47
- 使用 `npx` 即时运行任意命令,无需安装:
52
+ 全局安装并运行:
48
53
 
49
54
  ```bash
50
- npx unity-mcp-cli install-plugin /path/to/unity/project
55
+ npm install -g unity-mcp-cli
56
+ unity-mcp-cli install-plugin /path/to/unity/project
51
57
  ```
52
58
 
53
- 或全局安装:
59
+ 或使用 `npx` 即时运行任意命令,无需全局安装:
54
60
 
55
61
  ```bash
56
- npm install -g unity-mcp-cli
57
- unity-mcp-cli install-plugin /path/to/unity/project
62
+ npx unity-mcp-cli install-plugin /path/to/unity/project
58
63
  ```
59
64
 
60
- > **环境要求:** [Node.js](https://nodejs.org/) ^20.19.0 或 >=22.12.0。若未检测到 [Unity Hub](https://unity.com/download),将自动下载安装。
65
+ > **环境要求:** [Node.js](https://nodejs.org/) ^20.19.0 || >=22.12.0。若未检测到 [Unity Hub](https://unity.com/download),将自动下载安装。
61
66
 
62
67
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
63
68
 
64
69
  # 目录
65
70
 
66
71
  - [快速开始](#快速开始)
72
+ - [目录](#目录)
67
73
  - [命令](#命令)
68
- - [`configure`](#configure) — 配置 MCP 工具、提示词和资源
69
- - [`connect`](#connect) — 启动 Unity 并建立 MCP 连接
70
- - [`create-project`](#create-project) — 创建新 Unity 项目
71
- - [`install-plugin`](#install-plugin) — 将 Unity-MCP 插件安装到项目中
72
- - [`install-unity`](#install-unity) — 通过 Unity Hub 安装 Unity Editor
73
- - [`open`](#open) — 在编辑器中打开 Unity 项目
74
- - [`remove-plugin`](#remove-plugin) — 从项目中移除 Unity-MCP 插件
74
+ - [`configure`](#configure)
75
+ - [`create-project`](#create-project)
76
+ - [`install-plugin`](#install-plugin)
77
+ - [`install-unity`](#install-unity)
78
+ - [`open`](#open)
79
+ - [`run-tool`](#run-tool)
80
+ - [`setup-mcp`](#setup-mcp)
81
+ - [`setup-skills`](#setup-skills)
82
+ - [`remove-plugin`](#remove-plugin)
83
+ - [全局选项](#全局选项)
75
84
  - [完整自动化示例](#完整自动化示例)
76
85
  - [工作原理](#工作原理)
86
+ - [确定性端口](#确定性端口)
87
+ - [插件安装](#插件安装)
88
+ - [配置文件](#配置文件)
89
+ - [Unity Hub 集成](#unity-hub-集成)
77
90
 
78
91
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
79
92
 
@@ -84,7 +97,7 @@ unity-mcp-cli install-plugin /path/to/unity/project
84
97
  在 `UserSettings/AI-Game-Developer-Config.json` 中配置 MCP 工具、提示词和资源。
85
98
 
86
99
  ```bash
87
- npx unity-mcp-cli configure ./MyGame --list
100
+ unity-mcp-cli configure ./MyGame --list
88
101
  ```
89
102
 
90
103
  | 选项 | 必需 | 描述 |
@@ -107,7 +120,7 @@ npx unity-mcp-cli configure ./MyGame --list
107
120
  **示例 — 启用指定工具并禁用所有提示词:**
108
121
 
109
122
  ```bash
110
- npx unity-mcp-cli configure ./MyGame \
123
+ unity-mcp-cli configure ./MyGame \
111
124
  --enable-tools gameobject-create,gameobject-find \
112
125
  --disable-all-prompts
113
126
  ```
@@ -115,7 +128,7 @@ npx unity-mcp-cli configure ./MyGame \
115
128
  **示例 — 启用所有功能:**
116
129
 
117
130
  ```bash
118
- npx unity-mcp-cli configure ./MyGame \
131
+ unity-mcp-cli configure ./MyGame \
119
132
  --enable-all-tools \
120
133
  --enable-all-prompts \
121
134
  --enable-all-resources
@@ -123,71 +136,12 @@ npx unity-mcp-cli configure ./MyGame \
123
136
 
124
137
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
125
138
 
126
- ## `connect`
127
-
128
- 打开 Unity 项目并通过环境变量将其连接到指定的 MCP 服务器。每个选项均对应一个 `UNITY_MCP_*` 环境变量,Unity 插件将在启动时读取这些变量。
129
-
130
- ```bash
131
- npx unity-mcp-cli connect \
132
- --path ./MyGame \
133
- --url http://localhost:8080
134
- ```
135
-
136
- | 选项 | 环境变量 | 必需 | 描述 |
137
- |---|---|---|---|
138
- | `--url <url>` | `UNITY_MCP_HOST` | 是 | 要连接的 MCP 服务器 URL |
139
- | `--path <path>` | — | 是 | Unity 项目的路径 |
140
- | `--keep-connected` | `UNITY_MCP_KEEP_CONNECTED` | 否 | 强制保持连接 |
141
- | `--token <token>` | `UNITY_MCP_TOKEN` | 否 | 身份验证令牌 |
142
- | `--auth <option>` | `UNITY_MCP_AUTH_OPTION` | 否 | 认证模式:`none` 或 `required` |
143
- | `--tools <names>` | `UNITY_MCP_TOOLS` | 否 | 要启用的工具列表(逗号分隔) |
144
- | `--transport <method>` | `UNITY_MCP_TRANSPORT` | 否 | 传输方式:`streamableHttp` 或 `stdio` |
145
- | `--start-server <value>` | `UNITY_MCP_START_SERVER` | 否 | 设置为 `true` 或 `false` 以控制 Unity Editor 中 MCP 服务器的自动启动(仅适用于 `streamableHttp` 传输方式) |
146
- | `--unity <version>` | — | 否 | 要使用的特定 Unity Editor 版本(默认为项目设置中的版本,回退为已安装的最高版本) |
147
-
148
- 此命令携带相应的 `UNITY_MCP_*` 环境变量启动 Unity Editor,以便插件在启动时自动获取这些配置。运行时,环境变量将覆盖项目 `UserSettings/AI-Game-Developer-Config.json` 配置文件中的对应值。
149
-
150
- **示例 — 携带身份验证和指定工具连接:**
151
-
152
- ```bash
153
- npx unity-mcp-cli connect \
154
- --path ./MyGame \
155
- --url http://my-server:8080 \
156
- --token my-secret-token \
157
- --auth required \
158
- --keep-connected \
159
- --tools gameobject-create,gameobject-find,script-execute
160
- ```
161
-
162
- **示例 — 使用 stdio 传输方式连接(服务器由 AI 代理管理):**
163
-
164
- ```bash
165
- npx unity-mcp-cli connect \
166
- --path ./MyGame \
167
- --url http://localhost:8080 \
168
- --transport stdio \
169
- --start-server false
170
- ```
171
-
172
- **示例 — 使用 streamableHttp 连接并自动启动服务器:**
173
-
174
- ```bash
175
- npx unity-mcp-cli connect \
176
- --path ./MyGame \
177
- --url http://localhost:8080 \
178
- --transport streamableHttp \
179
- --start-server true \
180
- --keep-connected
181
- ```
182
-
183
- ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
184
-
185
139
  ## `create-project`
186
140
 
187
141
  使用 Unity Editor 创建新的 Unity 项目。
188
142
 
189
143
  ```bash
190
- npx unity-mcp-cli create-project /path/to/new/project
144
+ unity-mcp-cli create-project /path/to/new/project
191
145
  ```
192
146
 
193
147
  | 选项 | 必需 | 描述 |
@@ -198,7 +152,7 @@ npx unity-mcp-cli create-project /path/to/new/project
198
152
  **示例 — 使用指定编辑器版本创建项目:**
199
153
 
200
154
  ```bash
201
- npx unity-mcp-cli create-project ./MyGame --unity 2022.3.62f1
155
+ unity-mcp-cli create-project ./MyGame --unity 2022.3.62f1
202
156
  ```
203
157
 
204
158
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
@@ -208,7 +162,7 @@ npx unity-mcp-cli create-project ./MyGame --unity 2022.3.62f1
208
162
  将 Unity-MCP 插件安装到 Unity 项目的 `Packages/manifest.json` 中。
209
163
 
210
164
  ```bash
211
- npx unity-mcp-cli install-plugin ./MyGame
165
+ unity-mcp-cli install-plugin ./MyGame
212
166
  ```
213
167
 
214
168
  | 选项 | 必需 | 描述 |
@@ -224,7 +178,7 @@ npx unity-mcp-cli install-plugin ./MyGame
224
178
  **示例 — 安装指定插件版本:**
225
179
 
226
180
  ```bash
227
- npx unity-mcp-cli install-plugin ./MyGame --plugin-version 0.52.0
181
+ unity-mcp-cli install-plugin ./MyGame --plugin-version 0.51.6
228
182
  ```
229
183
 
230
184
  > 运行此命令后,请在 Unity Editor 中打开项目以完成包安装。
@@ -236,7 +190,7 @@ npx unity-mcp-cli install-plugin ./MyGame --plugin-version 0.52.0
236
190
  通过 Unity Hub CLI 安装指定版本的 Unity Editor。
237
191
 
238
192
  ```bash
239
- npx unity-mcp-cli install-unity 6000.3.1f1
193
+ unity-mcp-cli install-unity 6000.3.1f1
240
194
  ```
241
195
 
242
196
  | 参数 / 选项 | 必需 | 描述 |
@@ -249,25 +203,159 @@ npx unity-mcp-cli install-unity 6000.3.1f1
249
203
  **示例 — 安装项目所需的编辑器版本:**
250
204
 
251
205
  ```bash
252
- npx unity-mcp-cli install-unity --path ./MyGame
206
+ unity-mcp-cli install-unity --path ./MyGame
253
207
  ```
254
208
 
255
209
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
256
210
 
257
211
  ## `open`
258
212
 
259
- 在 Unity Editor 中打开 Unity 项目。
213
+ 在 Unity Editor 中打开 Unity 项目。默认情况下,若提供了连接选项,将设置 MCP 连接环境变量。使用 `--no-connect` 可在不建立 MCP 连接的情况下打开项目。
260
214
 
261
215
  ```bash
262
- npx unity-mcp-cli open ./MyGame
216
+ unity-mcp-cli open ./MyGame
217
+ ```
218
+
219
+ | 选项 | 环境变量 | 必需 | 描述 |
220
+ |---|---|---|---|
221
+ | `[path]` | — | 是 | Unity 项目的路径(位置参数或 `--path`) |
222
+ | `--unity <version>` | — | 否 | 要使用的特定 Unity Editor 版本(默认为项目设置中的版本,回退为已安装的最高版本) |
223
+ | `--no-connect` | — | 否 | 不携带 MCP 连接环境变量打开项目 |
224
+ | `--url <url>` | `UNITY_MCP_HOST` | 否 | 要连接的 MCP 服务器 URL |
225
+ | `--keep-connected` | `UNITY_MCP_KEEP_CONNECTED` | 否 | 强制保持连接 |
226
+ | `--token <token>` | `UNITY_MCP_TOKEN` | 否 | 身份验证令牌 |
227
+ | `--auth <option>` | `UNITY_MCP_AUTH_OPTION` | 否 | 认证模式:`none` 或 `required` |
228
+ | `--tools <names>` | `UNITY_MCP_TOOLS` | 否 | 要启用的工具列表(逗号分隔) |
229
+ | `--transport <method>` | `UNITY_MCP_TRANSPORT` | 否 | 传输方式:`streamableHttp` 或 `stdio` |
230
+ | `--start-server <value>` | `UNITY_MCP_START_SERVER` | 否 | 设置为 `true` 或 `false` 以控制 MCP 服务器的自动启动 |
231
+
232
+ 编辑器进程以分离模式启动 — CLI 会立即返回。
233
+
234
+ **示例 — 携带 MCP 连接打开:**
235
+
236
+ ```bash
237
+ unity-mcp-cli open ./MyGame \
238
+ --url http://localhost:8080 \
239
+ --keep-connected
240
+ ```
241
+
242
+ **示例 — 不携带 MCP 连接打开(简单打开):**
243
+
244
+ ```bash
245
+ unity-mcp-cli open ./MyGame --no-connect
246
+ ```
247
+
248
+ **示例 — 携带身份验证和指定工具打开:**
249
+
250
+ ```bash
251
+ unity-mcp-cli open ./MyGame \
252
+ --url http://my-server:8080 \
253
+ --token my-secret-token \
254
+ --auth required \
255
+ --tools gameobject-create,gameobject-find
256
+ ```
257
+
258
+ ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
259
+
260
+ ## `run-tool`
261
+
262
+ 通过 HTTP API 直接执行 MCP 工具。服务器 URL 和授权令牌会根据当前连接模式(自定义或云端),从项目配置文件(`UserSettings/AI-Game-Developer-Config.json`)中**自动解析**。
263
+
264
+ ```bash
265
+ unity-mcp-cli run-tool gameobject-create ./MyGame --input '{"name":"Cube"}'
263
266
  ```
264
267
 
265
268
  | 选项 | 必需 | 描述 |
266
269
  |---|---|---|
267
- | `[path]` | 是 | Unity 项目的路径(位置参数或 `--path`) |
268
- | `--unity <version>` | 否 | 要使用的特定 Unity Editor 版本(默认为项目设置中的版本,回退为已安装的最高版本) |
270
+ | `<tool-name>` | 是 | 要执行的 MCP 工具名称 |
271
+ | `[path]` | 否 | Unity 项目路径(位置参数或 `--path`)— 用于读取配置和检测端口 |
272
+ | `--url <url>` | 否 | 直接指定服务器 URL(跳过配置) |
273
+ | `--token <token>` | 否 | Bearer 令牌覆盖(跳过配置) |
274
+ | `--input <json>` | 否 | 工具参数的 JSON 字符串(默认为 `{}`) |
275
+ | `--input-file <file>` | 否 | 从文件中读取 JSON 参数 |
276
+ | `--raw` | 否 | 输出原始 JSON(无格式化、无加载动画) |
277
+ | `--timeout <ms>` | 否 | 请求超时时间(毫秒,默认:60000) |
269
278
 
270
- 编辑器进程以分离模式启动 — CLI 会立即返回。
279
+ **URL 解析优先级:**
280
+ 1. `--url` → 直接使用
281
+ 2. 配置文件 → `host`(自定义模式)或硬编码的云端点(云端模式)
282
+ 3. 根据项目路径生成的确定性端口
283
+
284
+ **授权**会从项目配置中自动读取(自定义模式使用 `token`,云端模式使用 `cloudToken`)。使用 `--token` 可显式覆盖从配置派生的令牌。
285
+
286
+ **示例 — 调用工具(URL 和授权来自配置):**
287
+
288
+ ```bash
289
+ unity-mcp-cli run-tool gameobject-find ./MyGame --input '{"query":"Player"}'
290
+ ```
291
+
292
+ **示例 — 显式指定 URL:**
293
+
294
+ ```bash
295
+ unity-mcp-cli run-tool scene-save --url http://localhost:8080
296
+ ```
297
+
298
+ **示例 — 管道传输原始 JSON 输出:**
299
+
300
+ ```bash
301
+ unity-mcp-cli run-tool assets-list ./MyGame --raw | jq '.results'
302
+ ```
303
+
304
+ ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
305
+
306
+ ## `setup-mcp`
307
+
308
+ 为 AI 代理写入 MCP 配置文件,支持在无 Unity Editor UI 的情况下进行无头/CI 设置。支持全部 14 种代理(Claude Code、Cursor、Gemini、Codex 等)。
309
+
310
+ ```bash
311
+ unity-mcp-cli setup-mcp claude-code ./MyGame
312
+ ```
313
+
314
+ | 选项 | 必需 | 描述 |
315
+ |---|---|---|
316
+ | `[agent-id]` | 是 | 要配置的代理(使用 `--list` 查看全部) |
317
+ | `[path]` | 否 | Unity 项目路径(默认为当前目录) |
318
+ | `--transport <transport>` | 否 | 传输方式:`stdio` 或 `http`(默认:`http`) |
319
+ | `--url <url>` | 否 | 服务器 URL 覆盖(用于 http 传输) |
320
+ | `--token <token>` | 否 | 授权令牌覆盖 |
321
+ | `--list` | 否 | 列出所有可用的代理 ID |
322
+
323
+ **示例 — 列出所有支持的代理:**
324
+
325
+ ```bash
326
+ unity-mcp-cli setup-mcp --list
327
+ ```
328
+
329
+ **示例 — 使用 stdio 传输方式配置 Cursor:**
330
+
331
+ ```bash
332
+ unity-mcp-cli setup-mcp cursor ./MyGame --transport stdio
333
+ ```
334
+
335
+ ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
336
+
337
+ ## `setup-skills`
338
+
339
+ 通过调用 MCP 服务器的系统工具 API 为 AI 代理生成技能文件。需要 Unity Editor 正在运行且已安装 MCP 插件。
340
+
341
+ ```bash
342
+ unity-mcp-cli setup-skills claude-code ./MyGame
343
+ ```
344
+
345
+ | 选项 | 必需 | 描述 |
346
+ |---|---|---|
347
+ | `[agent-id]` | 是 | 要生成技能的代理(使用 `--list` 查看全部) |
348
+ | `[path]` | 否 | Unity 项目路径(默认为当前目录) |
349
+ | `--url <url>` | 否 | 服务器 URL 覆盖 |
350
+ | `--token <token>` | 否 | 授权令牌覆盖 |
351
+ | `--list` | 否 | 列出所有代理及其技能支持状态 |
352
+ | `--timeout <ms>` | 否 | 请求超时时间(毫秒,默认:60000) |
353
+
354
+ **示例 — 列出支持技能的代理:**
355
+
356
+ ```bash
357
+ unity-mcp-cli setup-skills --list
358
+ ```
271
359
 
272
360
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
273
361
 
@@ -276,7 +364,7 @@ npx unity-mcp-cli open ./MyGame
276
364
  从 Unity 项目的 `Packages/manifest.json` 中移除 Unity-MCP 插件。
277
365
 
278
366
  ```bash
279
- npx unity-mcp-cli remove-plugin ./MyGame
367
+ unity-mcp-cli remove-plugin ./MyGame
280
368
  ```
281
369
 
282
370
  | 选项 | 必需 | 描述 |
@@ -292,23 +380,43 @@ npx unity-mcp-cli remove-plugin ./MyGame
292
380
 
293
381
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
294
382
 
383
+ ## 全局选项
384
+
385
+ 以下选项适用于所有命令:
386
+
387
+ | 选项 | 描述 |
388
+ |---|---|
389
+ | `-v, --verbose` | 启用详细诊断输出,用于故障排查 |
390
+ | `--version` | 显示 CLI 版本 |
391
+ | `--help` | 显示命令帮助信息 |
392
+
393
+ **示例 — 以详细输出运行任意命令:**
394
+
395
+ ```bash
396
+ unity-mcp-cli install-plugin ./MyGame --verbose
397
+ ```
398
+
399
+ ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
400
+
295
401
  # 完整自动化示例
296
402
 
297
403
  通过一个脚本从零搭建完整的 Unity MCP 项目:
298
404
 
299
405
  ```bash
300
406
  # 1. 创建新的 Unity 项目
301
- npx unity-mcp-cli create-project ./MyAIGame --unity 6000.3.1f1
407
+ unity-mcp-cli create-project ./MyAIGame --unity 6000.3.1f1
302
408
 
303
409
  # 2. 安装 Unity-MCP 插件
304
- npx unity-mcp-cli install-plugin ./MyAIGame
410
+ unity-mcp-cli install-plugin ./MyAIGame
305
411
 
306
412
  # 3. 启用所有 MCP 工具
307
- npx unity-mcp-cli configure ./MyAIGame --enable-all-tools
413
+ unity-mcp-cli configure ./MyAIGame --enable-all-tools
414
+
415
+ # 4. 配置 Claude Code MCP 集成
416
+ unity-mcp-cli setup-mcp claude-code ./MyAIGame
308
417
 
309
- # 4. 打开项目并建立 MCP 连接
310
- npx unity-mcp-cli connect \
311
- --path ./MyAIGame \
418
+ # 5. 打开项目并建立 MCP 连接
419
+ unity-mcp-cli open ./MyAIGame \
312
420
  --url http://localhost:8080 \
313
421
  --keep-connected
314
422
  ```
@@ -319,7 +427,7 @@ npx unity-mcp-cli connect \
319
427
 
320
428
  ### 确定性端口
321
429
 
322
- CLI 根据 Unity 项目的目录路径生成**确定性端口**(SHA256 哈希值映射到端口范围 50000–59999)。该端口生成机制与 Unity 插件中的实现完全一致,确保服务器与插件无需手动配置即可自动协商使用同一端口。
430
+ CLI 根据 Unity 项目的目录路径生成**确定性端口**(SHA256 哈希值映射到端口范围 20000-29999)。该端口生成机制与 Unity 插件中的实现完全一致,确保服务器与插件无需手动配置即可自动协商使用同一端口。
323
431
 
324
432
  ### 插件安装
325
433
 
@@ -343,6 +451,6 @@ CLI 根据 Unity 项目的目录路径生成**确定性端口**(SHA256 哈希
343
451
  - **macOS** — 下载 DMG,挂载后将 `Unity Hub.app` 复制到 `/Applications`
344
452
  - **Linux** — 将 `UnityHub.AppImage` 下载到 `~/Applications/`
345
453
 
346
- > 完整的 Unity-MCP 项目文档请参阅 [主 README](https://github.com/IvanMurzak/Unity-MCP/blob/main/README.md)。
454
+ > 完整的 Unity-MCP 项目文档请参阅[主 README](https://github.com/IvanMurzak/Unity-MCP/blob/main/README.md)。
347
455
 
348
456
  ![AI Game Developer — Unity MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "unity-mcp-cli",
3
- "version": "0.55.1",
4
- "description": "Cross-platform CLI tool for Unity-MCP operations — create projects, install plugins, configure tools, and manage MCP connections",
3
+ "version": "0.57.0",
4
+ "description": "Cross-platform CLI tool for AI Game Developer (Skills & MCP). Full AI develop and test loop. Efficient token usage, advanced tools. Creates Unity project, installs plugins, configures tools, and manages HTTP connection with Unity Editor and a game made with Unity. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "bin": {
@@ -16,15 +16,23 @@
16
16
  "prepack": "npm run build"
17
17
  },
18
18
  "keywords": [
19
+ "cli",
19
20
  "unity",
21
+ "unity ai",
22
+ "unity skills",
23
+ "unity mcp",
24
+ "ai skills",
25
+ "ai mcp",
26
+ "ai",
20
27
  "mcp",
21
28
  "model-context-protocol",
22
- "ai",
23
- "cli",
24
29
  "gamedev",
25
30
  "game-dev"
26
31
  ],
27
- "author": "Ivan Murzak",
32
+ "author": {
33
+ "name": "Ivan Murzak",
34
+ "url": "https://github.com/IvanMurzak"
35
+ },
28
36
  "license": "Apache-2.0",
29
37
  "repository": {
30
38
  "type": "git",