# @cmpose/mcp 中文文档

规范地址：https://npmcn.com/package/%40cmpose/mcp/

版本：2\.4\.5
npm 元数据更新时间：2026-11-08T09:41:16.336Z
中文译文更新时间：2026-11-10T04:15:37.565Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cmpose/mcp
原文对照：https://npmcn.com/package/%40cmpose/mcp/?lang=original
项目主页：https://github.com/whinstudio/cmpose/tree/develop/packages/mcp#readme
源码仓库：https://github.com/whinstudio/cmpose

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：44.4 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2026-10-13T21:42:01.408Z
- 最新版本发布：2026-11-08T09:41:16.218Z
- 近 30 天下载量：8241（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：47（近 12 个月 47 个）

## 中文简介

本地生成可构建的多平台(Android + iOS)项目和Unity游戏项目的 MCP 服务器

## 安装

```sh
npm install @cmpose/mcp
```

也可以使用：`pnpm add @cmpose/mcp`、`yarn add @cmpose/mcp`、`bun add @cmpose/mcp`

## README

# @ compose/ mcp (英语)

问你的人工智能经纪人 **组成多平台** 应用并获得一个真实可建的 Android + iOS 磁盘上的项目,由测试模板本地生成。 也会产生 **团结** 移动 游戏(Android + iOS)和独立 **克特林/克特尔后端**。这是本地的 MCP 具有六个工具的服务器 : `cmp_describe`, (中文(简体) ), `cmp_generate`, (中文(简体) ), `game_describe`, (中文(简体) ), `game_generate`, (中文(简体) ), `backend_describe` 财务报告和审定财务报表 `backend_generate`。它运行在您的机器上,没有账户,没有 API 键 没有上传.

> "创造出一个空白的"Compose"多平台应用程序,叫"Habits","pack com.acme". 习惯,在 ~/Projects, 有房间, 轻/暗地取景和广告。"

生成项目的开发者指南 : [https://whinstudio.github.io/cmpose/guide.html 互联网档案馆的存檔,存档日期2013-12-11](https://whinstudio.github.io/cmpose/guide.html)

## 安装

需要节点.js 20+和 git.

**克劳德代码**

```
claude mcp add -s user cmpose -- npx -y @cmpose/mcp
```

**Claude 桌面、 Cursor、 Windsurf 和其他 MCP 客户端** (单位:千美元)`mcpServers` 配置 :

```json
{
  "mcpServers": {
    "cmpose": { "command": "npx", "args": ["-y", "@cmpose/mcp"] }
  }
}
```

**VS 代码** (单位:千美元)`.vscode/mcp.json`:

```json
{
  "servers": {
    "cmpose": { "type": "stdio", "command": "npx", "args": ["-y", "@cmpose/mcp"] }
  }
}
```

## 你得到的东西

每个项目都有 `androidApp`, (中文(简体) ), `iosApp` (Xcode项目),a `shared` 带有 Koin 和 导航、 记录( Kermit) 、 图像加载( Coil) 、 程序内审查、 更新检查、 有关 屏幕, a `build-logic` 带有会话插件,并带有发布清单的 README.

-   **模板 :** `showcase` (家用、上岗和付费墙演示屏幕)或 `blank` (一个列出您模块的启动屏幕以及您选择的每个选项的演示) .
-   **备选方案 `blank`数字 :** Ktor 网络( 附带可选的应用网络检查员), 主题(轻/暗/系统)、多语言字符串、数据站、房间(KMP、捆绑的SQLite), 收入卡特公司采购,采用自定义的 " 组成付费墙 " 、经UMP/ATT同意的AdMob广告、Detekt、, 后端( Ktor 服务器, Firebase 签名, 共享; 仅空白; 打开多语言和 网络),洞察力(Firebase Crashlytics + Analytics; 在添加Firebase配置之前关闭 文档).
-   **您自己的功能模块 :** 最多3个,各有合同/数据/领域/介绍层.
-   **CI: 爱奇艺** 一个可选的 GitHub 动作工作流程.
-   **到处都是你的名字:** 软件包、捆绑代号、应用程序名称、min SDK和iOS部署目标.

## 游戏( 团结 )

> "创造出一款叫"SkyHopper"的2DUnity游戏,包裹com.acme. 在~/项目,空白, 广告和主板"

每个游戏项目都是为Android和iOS开发的Unity 6项目(编辑器6000.3.25f1,URP),其中 VContainer + UniTask,一个uGUI接口,一个boot → 菜单 → 游戏场景流,一个设置屏幕, 保存、 深链接、 应用中审查和更新检查 .

-   **模板 :** `showcase` (每个旗子的样本游戏: 2D 跑者,或 3D 音轨 `render: "3d"`)或(或) `blank` (空相游戏取出所取旗帜. `render` 实值 `2d` (违约)或 `3d`。 。 。 .
-   **旗帜用于 `blank`数字 :** `saveSystem`, (中文(简体) ), `multiLang`, (中文(简体) ), `network`, (中文(简体) ), `networkInspector` (需求数) `network`他为你们而加盟, `purchases` (评论卡特), `ads` (非洲集团), `leaderboards` (谷歌游戏游戏和游戏中心)和 `insights` (火基崩盘+ 分析; 在添加前关闭 `google-services.json` 财务报告和审定财务报表 `GoogleService-Info.plist` 改为 `Assets/Firebase`,报告为警告).
-   **您自己的功能模块( E)`blank`:** 最多3个.
-   **身份证:** `ids` 带您真正的 AdMob (`admob`),收入表`revenueCat`)和游戏+ 游戏中心( E)`gameServices`(a) 身份证,每个团体都有其旗帜; `game_describe` 列出字段. 你留下的一组保留测试ID/占位符,并报告为警告.
-   **听着`theme`:** 模板的风格家族之一( t)`bright`, (中文(简体) ), `neon`, (中文(简体) ), `pastel`, (中文(简体) ), `bold`, (中文(简体) ), `nature`, (中文(简体) ), `clean`; 调色板、形状、运动和字体对),由 `game_describe` 下级 `themes` 用每件西装. `theme: { family, primary, accent, fontPair }`,每个字段 选项: `primary` 财务报告和审定财务报表 `accent` (单位:千美元)`#RRGGBB`将家庭的光线改变 直到文本和按钮保持其对比; 仍然无法通过的颜色保持 被报告为警告 无 `theme` 项目得到 `clean`,与 模板将它.
-   **到处都是你的名字:** 软件包(应用程序标识符)、公司名称、应用程序名称、min SDK (25至36)和iOS部署目标(1.5至26.2).

> "创建后端名为"NotesBackend",服务名Note-api,pack com.acme. 注释,在 ~/项目,共享"

每个后端都有一个 Kotlin (JVM 21) Ktor 服务器 有 PostgreSQL (Exposed, Flyway), Firebase ID 在服务器上校验的符号( 无 Admin SDK ), 文件上传, 账户删除, 一个样本功能 \* 复制安全核对表,一名当地跑者`./gradlew runLocal`及其部署部分 作为Nginx后面的一个多克容器. `sharing` 增加空间、角色和邀请.

## 工具

-   `cmp_describe`: 默认、选项和规则(名称格式、限制、哪个选项) (b) 需要哪些资源。 探员们先打电话来.
-   `cmp_generate`:创建项目. 要求 : `projectName` (只有信件,最多30个), `appName` (最多30个字符), `packageName` (例如:. `com.acme.habits`,最多50个字符) 和绝对 `outputDir`可选: `templateType`, (中文(简体) ), `features` (单元名称至20个), `featuresConfig`, (中文(简体) ), `minSdk` (24至36个), `iosVersion` (15.0至26.2) (中文(简体) ), `ci`, (中文(简体) ), `templateRef`, (中文(简体) ), `backendTemplateRef` (后端模板标记为 `server/` 来源; 空白 仅限后端). 它返回工程路径, 它使用的模板版本, 警告( 例如测试 ad IDs to 和下一步.
-   `game_describe`: Unity 游戏生成器的引擎和编辑器版本,模板类型, 制作、标记及其依赖、ID组、默认、限制和被绑定模板 主题家庭( e)`themes`数字 : `default` 每个家庭 `id`, (中文(简体) ), `title`, (中文(简体) ), `suits` 财务报告和审定财务报表 `fontPairs`· ; 第一个呼叫下载模板。 探员们先打电话来.
-   `game_generate`:创建游戏. 要求 : `projectName` (1至30个字母或数字, 从一封信开始, `appName` (最多30个字符), `packageName` (例如:. `com.acme.skyhopper`,至少3个区段,最多50个字符)和绝对值 `outputDir`。 。 。 . 可选 : `companyName` (比如说) `projectName`;默认情况下,包的第二段, 资本化, `templateType`, (中文(简体) ), `render`, (中文(简体) ), `flags`, (中文(简体) ), `features` (模块名称:1至20个小写) 字母或数字,从字母开始, `minSdk` (25至36个), `iosVersion` (15.0至26.2) (中文(简体) ), 写为 `major.minor`, (中文(简体) ), `ids`, (中文(简体) ), `theme`, (中文(简体) ), `templateRef`。它不会覆盖一个非空的 文件夹。 结果命名了应用主题( Q)`theme`并列出 警告! 警告你们.
-   `backend_describe`:后端生成器的选项, `appName` 项目解剖学和 增加代码时应遵循的公约(受保护路线,404规则,特征) 安全检查单、配额、当地跑道和部署部件)。 探员们先打电话来.
-   `backend_generate`: 创建后端. 要求 : `projectName` (只有信件,最多30个), `appName` (服务名称:2至31个小写字母、数字或 `-`从一封信开始; 没有 `api`, (中文(简体) ), `health`, (中文(简体) ), `admin` 或者说 `static`, (中文(简体) ), `packageName` (例如:. `com.acme.notes`和一个 绝对 `outputDir`可选: `sharing` (默认) `false`, (中文(简体) ), `sample` (抽样项目) 特性,默认 `true`, (中文(简体) ), `templateRef`。它永远不会覆盖一个非空文件夹. `CMPOSE_BACKEND_TEMPLATE_DIR` (后端模板检查的绝对路径)生成 而不是贴上标签.

## 如何运作

一代完全运行在你的机器上。 第一次通话下载被绑的模板 (单位:千美元)[风喉/风喉](https://github.com/whinstudio/cmpose-template)改为: `$XDG_CACHE_HOME/cmpose` (次数) `~/.cache/cmpose`; 覆盖到 `CMPOSE_CACHE_DIR`)),后来 调用重用它。 游戏来了 与被绑的游戏模板相同 (单位:千美元)[wh/相扑-游戏-模式](https://github.com/whinstudio/cmpose-game-template); 团结 从不运行在一代。 后端来自被绑定后端模板 (单位:千美元)`whinstudio/cmpose-backend-template`) (中文(简体) ). 每个发布标注每个模板的一个标记,所以 `@cmpose/mcp@x.y.z` 总是生成相同的项目.

资料来源和问题: [github.com/whinstudio/cmpose (中文(简体) )](https://github.com/whinstudio/cmpose)。 。 。 . 麻省理工学院有执照 你创造的项目是你的.

## 常见问题

### @cmpose/mcp 是什么？

本地生成可构建的多平台\(Android \+ iOS\)项目和Unity游戏项目的 MCP 服务器

### 如何安装 @cmpose/mcp？

在项目目录运行 npm install @cmpose/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cmpose-mcp，可以用 npx cmpose-mcp 直接运行。

### @cmpose/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cmpose\_\_mcp 是否存在。

### @cmpose/mcp 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cmpose/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cmpose/mcp 可以商用吗？

@cmpose/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cmpose/mcp 的下载量有多少？

根据 npm 官方下载统计，@cmpose/mcp 在 2026/10/10 – 2026/11/08 这 30 天内被下载 8,241 次，日均约 275 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cmpose/mcp 还在维护吗？

最新版本 2\.4\.5 发布于 2026/11/08（1 天前）；至今共发布 47 个版本，其中过去 12 个月发布了 47 个；首次发布于 2026/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。