SuperAPI AI 工具集

create-sunpeak-app

智能体与模型

查看项目

更新于 10-15 16:47

技能介绍

用途:Sunpeak 是构建在 @modelcontextprotocol/ext-apps 之上的 React 框架,用于开发 MCP App——即运行在 AI 聊天宿主(ChatGPT、Claude)内部的、带交互式 UI 的应用。它通过约定式项目结构、React hooks、开发检查器与 CLI 简化 MCP 工具与资源 UI 的开发。

主要能力:提供 useToolData、useHostContext、useDisplayMode、useCallServerTool、useSendMessage 等 React hooks;支持资源组件(ResourceConfig + React 组件,mimeType 为 text/html;profile=mcp-app)、工具文件(metadata、Zod schema、可选 outputSchema、handler)、仅后端工具(确认循环,review 工具通过 action 字段统一处理各类审核)、模拟数据文件(tests/simulations/*.json,含 tool、userMessage、toolInput、toolResult、serverTools)以及使用 SafeArea 与 MCP CSS 变量适配宿主。

使用方式:克隆参考仓库获取模板(git clone --depth 1 https://github.com/Alignbase/sunpeak /tmp/sunpeak),模板位于 packages/sunpeak/template/;项目按 src/resources/{name}/{name}.tsx、src/tools/{name}.ts 等约定组织;资源与工具名称自动从目录或文件名推导。CLI 提供 sunpeak dev / sunpeak build / sunpeak start。组件需用 SafeArea 包裹,hooks 需在提前返回前调用,使用 useToolData<TInput,TOutput>() 提供输入输出类型。开发者可通过 tests/ 下的 simulations、e2e(Playwright)、evals、live 目录组织测试。

适用场景:为 MCP 工具添加 UI、构建 ChatGPT App / MCP App、开发带交互界面的资源;ChatGPT 应用现以插件形式提交发布,但应用部分仍由 MCP 支撑,故 sunpeak 的服务端、工具、资源与运行时保持一致。

限制:资料未提供具体收费、价格、性能数据与完整安装命令细节;模板深克隆与详细 CLI 参数暂未提供;官方文档文本暂未提供,以上仅依据所给资料整理。