# kasy-mcp 中文文档

规范地址：https://npmcn.com/package/kasy-mcp/

版本：0\.25\.0
npm 元数据更新时间：2026-11-03T22:55:18.930Z
中文译文更新时间：2026-11-04T00:09:16.650Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/kasy-mcp
原文对照：https://npmcn.com/package/kasy-mcp/?lang=original

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

- 包体积（解压后）：498 kB，99 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：5 个
- 首次发布：2026-07-19T17:45:30.447Z
- 最新版本发布：2026-11-03T22:55:18.731Z
- 已发布版本数：105（近 12 个月 105 个）

## 中文简介

用于Kasy套件的MCP服务器。让任何具有mcp功能的AI （Claude Desktop, Claude Code, Cursor，…）准备一台机器，支架一个Kasy项目，并构建遵循套件设计系统的屏幕，而无需触摸终端。

## 安装

```sh
npm install kasy-mcp
```

也可以使用：`pnpm add kasy-mcp`、`yarn add kasy-mcp`、`bun add kasy-mcp`

## README

# kasy-mcp

一个 [MCP](https://modelcontextprotocol.io/) 的服务器 [Kasy](https://kasy.dev/) 装备。 它运行 **本地在您的机器上** 通过npm/npx免费安装，无需服务器 由凯西主持，并揭露了 `kasy` 的依赖项 这个包，没有其他安装)作为工具，任何mcp功能的AI可以调用： 克劳德桌面，克劳德代码，光标，以及任何能说MCP的东西。

它还将该项目自己的设计系统指南作为MCP资源公开，因此 AI读出 _这_ 项目的实际组件/令牌/文档 屏幕，而不是猜测或发明原材料部件。

## 它比跑步增加了多少 `kasy` 在终端

从技术上讲，没有什么——这里的每个工具都是一样的 `kasy` 命令 你自己去查，包括检查驾照。重点是给那些 没有（或不想要）终端：询问“用Kasy准备我的机器”或 在聊天中“与Kasy一起创建一个项目”，AI通过这个MCP完成它 而不是向您介绍复制粘贴的命令。

## 安装

**稳定(推荐):**

```bash
npm install -g kasy-mcp
```

```json
{
  "mcpServers": {
    "kasy": {
      "command": "kasy-mcp"
    }
  }
}
```

**快速开始使用npx** (第一次尝试没问题；如果MCP在更新后变成红色，运行 `kasy doctor --heal-mcp` 或者切换到上面的全局安装)：

```
claude mcp add kasy -- npx -y kasy-mcp
```

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

## 工具(概述)

| 区域 | 工具 |
| --- | --- |
| 机 | `prepare_machine`， `run_setup_command`， `check_kasy_updates`， `upgrade_kasy` |
| 项目 | `create_project`， `list_features`， `add_feature`， `remove_feature`， `check_status`， `check_project`， `configure_status`， `update_project`， `deploy_backend`， `deploy_backend_status`， `create_project_status`， `configure_backend`， `list_flows`， `add_flow`， `kanban` |
| 运行 | `run_app`， `reload_app`， `stop_app`， `reset_app`， `clear_web_storage` |
| 品牌 | `rebrand_project` （引导性：询问、预览，只在同意后才适用）， `rename_app` (临时名称→最终名称；发布前仅提供商店ID；然后预览 `confirmed: true`）， `set_primary_color`， `set_icon`， `set_splash`， `set_favicon` |
| 编制 | `create_screens`， `finalize_project` （两者都返回云剧本；人工智能完成工作） |
| 手机登录 | `setup_phone_login` （检查，启用，禁用） |
| 凭证 | `configure_license`， `setup_social_login`， `configure_apple_web`， `configure_facebook_login`， `configure_google_login`， `configure_ios_signing`， `configure_android_signing`， `configure_codemagic`， `configure_project_keys`， `set_notification_texts` |
| 发布 | `release_ios`， `build_ios`， `clean_ios`， `release_android`， `build_aab`， `build_apk_signed`， `build_apk`， `codemagic_release`， `codemagic_status`， `manage_domain`， `set_release_version` |
| 修复 | `fix_project` |
| 设计 | `list_components` |
| 浏览器测试 | `browser_qa_guide` |
| 逃避 | `list_commands`， `run_kasy_command`， `read_kasy_docs`， `report_issue` |

`run_app` 询问（通过助手）哪个平台，以及为网页是否打开 扑动Chrome或仅打印 `http://localhost:5555`． 做。 **不** 使用 `run_kasy_command` 为 `kasy run`。

这个 `configure_*` 工具取代了交互式向导(`kasy ios/android/ codemagic configure`,满 `kasy configure`)，它不能在MCP上运行，因为 stdin关闭：助手通过结构化测验UI或收集每个值 首先是MCP引出，然后调用所有的工具一次。

## 授权剧本（包含长说明）

`rebrand_project`， `create_screens` 和 `finalize_project` 不要用代码传达他们的指令。他们问 `kasy-playbook` edge函数，该函数仅为此机器上的活动订阅返回Markdown。在npm包中没有公共页面和副本。如果没有密钥、使用非活动计划、在其他设备上或脱机，工具将返回 `PLAYBOOK LOCKED`。

| 什么 | 在 |
| --- | --- |
| 真相来源（编辑此处） | `mcp/playbooks/*.md` |
| 函数包（生成） | `license-server/supabase/functions/kasy-playbook/bundle/` |
| 公共页面 | 只有一个存根 `site/kasy-v3/public/mcp/playbooks/` |

发布指令变更：

```bash
# 1. edit mcp/playbooks/<name>.md
node mcp/scripts/sync-playbooks.js
node mcp/test/playbooks.test.js
# 2. deploy the function (not the marketing site):
supabase functions deploy kasy-playbook --project-ref xkefozfsrmqjtesiitvk
```

`create_screens` 立即为一个屏幕构建。整个产品通过 `finalize_project`，每次返回一个阶段并将其记录在 `~/.kasy/flow-runs/`。 `create_project` 和 `create_screens` 拒绝，直到该工具返回构建阶段，在总结是和计划是之后（计划是包括是否有引用，以及推送的路由）。没有参考，工具包欢迎，登录，注册，主页和设置保留。有了参考，每个产品屏幕都按照该外观重新构建（欢迎、登录、注册、配置文件、设置演示、菜单）。付费墙和管理仍然是工具包。这个计划也需要 `referenceImages` （路径强制引用，即使是简短的）和 `checks` （轻按一下工具即可执行）。在验证之前，助手会再次查看每个屏幕（保真度、动作、目的地），并指出它在哪个屏幕上，而不是保持沉默。Verify驱动正在运行的web应用程序本身，在明暗、手机和屏幕上，将屏幕颜色与图像进行比较，执行这些点击，然后运行 `flutter analyze`。 `.kasy/screen-audit.json` 不通过。当产品屏幕仍然是工具包文件或使用时，验证也会保留 `ListTile`． 测试在聊天旁边的编辑器浏览器中运行，每次运行一个屏幕。和那个人谈谈打开的屏幕，用简单的语言，用谈话的语言。不要说几分钟就好。 `rebrand_project` 仍然只适用于 `confirmed: true`。

## 结构化用户问题（测验UI）

当一个工具需要几个选择(创建项目，运行平台，配置 巫师)，经纪人应该这样做 **不** 在聊天中粘贴编号的降价列表。

1.  **IDE测验（游标）：** 一步一步地使用AskQuestion，然后调用工具 所有的参数。做。 **不** 集 `useElicitationForm` 在光标。光标MCP 引出渲染器不转动 `enum` 进入下拉菜单并可以预填充 第一个枚举值，因此表单不能替代AskQuestion。
2.  **MCP启发:** 对于没有测试UI的客户端（Claude Desktop等），调用 工具 `useElicitationForm: true` 缺少必需的参数。选择 字段使用空白的第一个枚举值，以便客户端自动填充 `enum[0]` 不 选择一个真正的默认值。
3.  **回退:** 只有在两者都不存在的情况下才会有一个简短的开放性问题。

## 资源

| URI | 什么 |
| --- | --- |
| `kasy://design-system-guide` | 生活 `DESIGN_SYSTEM.md` + `AGENTS.md` 从开放项目 |
| `kasy://architecture` | 功能优先的文件夹/数据流约定 |

## 地方发展

```bash
npm install
node scripts/smoke-test.js
```

## 常见问题

### kasy-mcp 是什么？

用于Kasy套件的MCP服务器。让任何具有mcp功能的AI （Claude Desktop, Claude Code, Cursor，…）准备一台机器，支架一个Kasy项目，并构建遵循套件设计系统的屏幕，而无需触摸终端。

### 如何安装 kasy-mcp？

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

### kasy-mcp 支持 TypeScript 吗？

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

### kasy-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### kasy-mcp 需要什么版本的 Node\.js？

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

### kasy-mcp 可以商用吗？

kasy-mcp 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### kasy-mcp 还在维护吗？

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