mcpField
M
mcp-app-builder

mcp-app-builder

github.com/alpic-ai开发2.2k201 次安装今天更新
代码仓库

关于 mcp-app-builder

mcp-app-builder 是用于创建对话式 MCP Apps 的 Skill,应用通过工具和自定义界面扩展 AI 助手。它提供从规划、实现到测试、部署和发布的步骤指引。

主要功能

  1. 01使用 SPEC.md 管理需求与设计
  2. 02架构和实现指导
  3. 03自定义界面与 LLM 上下文指导
  4. 04本地测试与模型评估
  5. 05部署和目录发布指导

适用场景

  1. 01根据已有 SPEC.md 启动应用
  2. 02设计供人和 AI 助手协作的界面
  3. 03实现身份验证或数据获取流程
  4. 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。

设置

  1. 复制模板 → copy-template.md:使用现成 SPEC.md 启动新项目时
  2. 在本地运行 → run-locally.md:准备测试、需要开发服务或 ChatGPT/Claude 连接时
  3. 评估 → 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

评论

支持 Markdown