SuperAPI AI 工具集

convert-web-app

智能体与模型

查看项目

更新于 10-15 17:24

技能介绍

用途:把已有 Web 应用改造成混合 MCP App,保留原有独立网页形态,同时新增在 MCP 主机中内联渲染的能力,渲染逻辑共用,仅数据来源不同。

主要能力:通过薄初始化层检测运行环境(如 origin 为 null 的沙箱 iframe),在 MCP 模式下从工具生命周期(ontoolinput、ontoolresult)取参数,独立模式下从 URL 参数取参数;新建 MCP 服务器把打包后的 HTML 注册为资源并注册展示工具;支持主机主题与样式变量、全屏模式、流式部分输入、仅应用可见的辅助工具,以及非 UI 主机的文本回退。

使用方式:克隆 SDK 参考代码:git clone --branch "v$(npm view @modelcontextprotocol/ext-apps version)" --depth 1 https://github.com/modelcontextprotocol/ext-apps.git /tmp/mcp-ext-apps;安装依赖:npm install @modelcontextprotocol/ext-apps @modelcontextprotocol/sdk zod,npm install -D tsx vite vite-plugin-singlefile;用 registerAppTool、registerAppResource 注册工具与资源;用 vite-plugin-singlefile 将 UI 打包为单文件 HTML,服务器单独编译;在应用启动时按环境选择初始化路径。

适用场景:已有 React、Vue、Svelte、Preact、Solid 或原生 JS 网页,希望同时支持独立访问与 MCP 主机内嵌展示。

限制:MCP App 的 HTML 运行在无同源服务器的沙箱 iframe 中,所有外部来源必须在 CSP 中声明(resourceDomains、connectDomains、frameDomains),缺失会静默失败;localStorage/sessionStorage 在沙箱 iframe 中不可用,需改用 structuredContent 或服务端状态;需为不支持 UI 的主机提供文本回退。具体收费、价格与平台支持情况暂未提供。