SuperAPI AI 工具集

OpenAI Apps MCP

智能体与模型

查看项目

更新于 10-16 03:14

技能介绍

用途:该技能提供在生产环境验证过的模式,用于构建 OpenAI Apps——通过 Model Context Protocol(MCP)扩展 ChatGPT 功能,重点是无状态 MCP 服务器部署在 Cloudflare Workers 上,覆盖其大部分用例。ChatGPT 用户可借此在对话中访问第三方服务、显示交互式小组件(地图、轮播、列表等)、执行返回结构化 UI 组件的工具。

架构:ChatGPT(发现并调用工具)→ MCP 服务器(你的 Cloudflare Worker),包含工具处理器(业务逻辑)、小组件资源(HTML/JS UI)和 OpenAI 元数据(输出模板)。

主要能力与用法:使用 npm create cloudflare@latest my-openai-app -- --type hello-world --ts --git --deploy false 搭建项目,安装 @modelcontextprotocol/sdk、hono、zod 及 @cloudflare/vite-plugin、vite。配置 wrangler.jsonc 时需启用 nodejs_compat,设置 assets.directory 与 binding ASSETS。MCP 服务器须为 /mcp/* 配置 CORS 允许 https://chatgpt.com,注册工具时使用面向动作的描述(如“Use this when...”),小组件资源 URI 须以 ui://widget/ 开头,MIME 类型须为 text/html+skybridge,工具响应中通过 _meta.initialData 向小组件传数据。构建后用 npx wrangler deploy 部署,并用 npx @modelcontextprotocol/inspector 测试。

限制与注意:不要使用第三方 CDN 脚本(可能被 CSP 拦截)、不要使用自定义 MIME 类型、不要遗漏 CORS、不要跳过输入校验(工具会接收不可信数据)。Workers 上 SSE 无数据 100 秒会超时,需发心跳。其他具体收费、平台细节暂未提供。