kasy-mcp

中文文档
0.25.0发布于 2026/11/04UNLICENSEDES Module

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

中文使用文档
文档目录7 节
  1. 它比跑步增加了多少 kasy 在终端
  2. 安装
  3. 工具(概述)
  4. 授权剧本(包含长说明)
  5. 结构化用户问题(测验UI)
  6. 资源
  7. 地方发展

kasy-mcp

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

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

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

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

安装

稳定(推荐):

npm install -g kasy-mcp
{
  "mcpServers": {
    "kasy": {
      "command": "kasy-mcp"
    }
  }
}

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

claude mcp add kasy -- npx -y kasy-mcp
{
  "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/

发布指令变更:

# 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功能优先的文件夹/数据流约定

地方发展

npm install
node scripts/smoke-test.js

版本与发布记录

kasy-mcp 共发布 105 个版本,首次发布于 2026/07/20;过去 12 个月发布了 105 个版本。

版本发布日期距今
0.25.0latest2026/11/041 天前
0.24.92026/11/032 天前
0.24.82026/11/032 天前
0.24.72026/11/032 天前
0.24.62026/11/032 天前
0.24.52026/11/023 天前

关于 kasy-mcp 的常见问题

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 和提交记录判断。