关于 mcp-app-builder
mcp-app-builder 是用于创建对话式 MCP Apps 的 Skill,应用通过工具和自定义界面扩展 AI 助手。它提供从规划、实现到测试、部署和发布的步骤指引。
主要功能
- 01使用 SPEC.md 管理需求与设计
- 02架构和实现指导
- 03自定义界面与 LLM 上下文指导
- 04本地测试与模型评估
- 05部署和目录发布指导
适用场景
- 01根据已有 SPEC.md 启动应用
- 02设计供人和 AI 助手协作的界面
- 03实现身份验证或数据获取流程
- 04测试并发布 MCP App
MCP 相关
该 Skill 指导构建作为 MCP 服务运行的对话式应用,向 AI 助手提供工具和自定义界面。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alpic-ai/ skybridge --skill mcp-app-builder安装后在 Claude Code 中输入/mcp-app-builder确认已加载。
详细介绍
创建 MCP 应用
这些对话式体验通过工具和自定义 UI 视图扩展 AI 助手。它们以 MCP 服务的形式构建,会在对话过程中被调用。
⚠️ 该应用会同时被两类用户使用:人类和 AI 助手大模型。他们通过视图协作——人类与视图交互,大模型则能看到视图的状态。在编写代码前,请牢记这一点:视图是双方共享的界面。
SPEC.md 用于记录应用的需求和设计决策。开发应用时,请及时更新。
没有 SPEC.md? → 请先阅读 discover.md。在 SPEC.md 创建之前,不要做其他事情。
已有 SPEC.md? → 阅读 SPEC.md,然后按照 architecture.md 设计变更。更新 SPEC.md 后,再阅读下方相关的实现参考文档,然后编写代码。
从 Skybridge < 0.36.x 迁移? → 请先阅读 migrate-to-v1.md。用户可能会将 skybridge >= 0.36.x 称为 v1。
从 Skybridge 1.x 迁移到 2.x? → 请先获取 v2.0.0 发布说明,并按其中的说明操作。
构建电商应用? → 请先阅读 ecommerce.md。
设置
- 复制模板 → copy-template.md:使用现成 SPEC.md 启动新项目时
- 在本地运行 → run-locally.md:准备测试、需要开发服务或 ChatGPT/Claude 连接时
- 评估 → evals.md:在测试中检查真实模型是否能根据自然语言提示调用正确的工具
架构
设计或演进 UX 流程和 API 形态 → architecture.md
实现
- 获取并呈现数据 → fetch-and-render-data.md:实现服务端处理程序和视图数据获取时
- 状态和上下文 → state-and-context.md:持久化视图 UI 状态并更新大模型上下文时
- 提示大模型 → prompt-llm.md:视图需要触发大模型响应时
- UI 指南 → ui-guidelines.md:显示模式、布局约束、主题、设备和区域设置
- 外部链接 → open-external-links.md:重定向到外部 URL 或设置“在应用中打开”的目标时
- 下载文件 → download-file.md:将内容保存到用户的文件系统时
- OAuth → oauth.md:工具需要用户身份验证才能访问用户专属数据时
- CSP → csp.md:声明允许获取数据、加载资源、重定向或使用 iframe 的域名时
部署
- 发布到生产环境 → deploy.md:准备通过 Alpic 部署时
- 发布到 ChatGPT/Claude 目录 → publish.md:准备提交审核时
完整 API 文档:https://docs.skybridge.tech/api-reference.md
发布说明和变更日志:https://skybridge.tech/changelog.md