← 返回目录

MCP Apps

官方

框架 / SDK

为MCP工具调用提供内嵌交互式UI的规范与SDK。

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 121 / 438
Stars: ★ 3.0k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 6 天前

60FMRS · C

MCP Apps 是 modelcontextprotocol 组织官方维护的协议扩展仓库,提供规范文档、多包 SDK 及约20个示例服务器,用于让 MCP 工具返回可在兼容聊天客户端中渲染的交互式UI,而非本身作为单一可安装的 MCP 服务器;适合需要构建富交互体验的服务器开发者,但需自行确认目标宿主的支持程度及许可证状态。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

12/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 该仓库没有缓存的服务器清单，README 也说明这是一个规范(spec)+SDK+多个示例服务器的集合，而非单一可运行的 MCP 服务器，'服务器路径:仓库根目录'本身就说明对象边界不清。README 中展示的是文档链接、徽章和示例列表，没有提供可核验的测试文件或工具声明与实际行为一致性的证据，CI 徽章仅为图片链接，未附带工作流内容或测试覆盖证据。按静态评审规则，缺乏可验证的执行证据时可靠性不得超过12分，故给出8分,体现'happy path看似可行但边界/错误处理/一致性均未经核实'的情况。
安全与权限 12/20: README提到UI通过host在'沙箱化iframe'中渲染，且工具数据通过通知/受控通道在host与UI间传递，这是一个较为合理的隔离设计思路，未发现红线级风险(无凭据窃取、无隐蔽外泄、无未经确认的破坏性默认操作)。但作为协议/SDK仓库,具体的权限模型、最小权限约束、危险操作确认机制、外部网络访问边界等均未在README中给出可核查细节,示例服务器(如系统监控、地图、PDF等)可能涉及本地资源或网络访问但未见说明。证据不足以判定'明确的最小权限和数据流披露',因此给12分,即'主要风险可见但权限/确认/范围披露不完整'。
维护活跃度 12/20: 仓库由官方modelcontextprotocol组织维护,npm包持续发布并有下载量徽章、CI徽章、CONTRIBUTING.md,star数2682,呈活跃状态。但一个关键问题是:GitHub报告许可证为NOASSERTION(未声明/无法识别的许可证),而README徽章却声称'License: Apache 2.0',二者存在矛盾,这是治理和许可证清晰度上的明显缺陷。同时开放issue数高达191,未见明确的安全响应渠道说明。综合活跃度尚可但许可证矛盾与治理透明度不足,扣分后给12分。
文档质量 15/20: README结构完整,包含目录、快速入门链接、API文档链接、多个客户端支持说明、SDK各包用途表格、丰富的示例列表(12+个示例服务器及5种框架的starter模板)、规范版本表、贡献指南链接,层次分明、示例充分。但由于没有服务器清单(manifest)可查,无法核实具体工具参数、限制、成本或故障排查细节层面的文档质量,这部分证据缺失,故未给满分,给15分。
安装易用性 13/20: README提供了清晰的安装步骤:npm install命令、Quickstart指南链接、本地运行示例的git clone+npm install+npm start流程,以及针对stdio客户端(如Claude Desktop、VS Code)的JSON配置示例,并说明了本地开发时如何指向本地构建。步骤具体且给出了配置样例,体现了较低的上手门槛。但按静态评审规则,在没有真实CI工作流内容和已提交测试可验证覆盖关键路径之前,setup不得超过15分;且仓库是多包/多示例结构,实际选择并配置某个具体示例服务器可能存在额外复杂度(如Python示例需uv run),故给13分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

需要在工具调用结果中渲染富交互界面的 MCP 服务器开发者
已经在使用支持 MCP Apps 扩展的宿主(如 Claude、ChatGPT、VS Code、Goose、Postman)的团队
希望参考官方规范和多种前端框架(React/Vue/Svelte/Preact/Solid/原生JS)起始模板的开发者

不适合谁

只想要一个开箱即用的单一 MCP 服务器/工具的用户(本仓库是协议规范+SDK+示例集合,不是单一服务器)
客户端宿主不支持 MCP Apps 扩展的场景(README明确指出各宿主支持程度不同)
需要生产级、官方维护的宿主实现的用户(README明确说明仓库内除示例性质的 basic-host 外不提供受支持的宿主实现)

所需权限

SDK 与规范本身不涉及特定权限;具体权限取决于所使用的示例服务器(如系统监控示例可能读取本机系统指标,视频资源示例会提供二进制媒体资源)
README 未给出针对单一服务器的完整权限清单

风险与副作用

UI 内容以服务器提供的 HTML 资源形式在宿主沙箱 iframe 中执行,实际隔离与信任边界取决于具体宿主实现,而非本仓库本身保证
规范存在 2026-01-26 稳定版与仍在开发中的 draft 版本,接口可能随规范演进而变化
仓库许可证标注(README徽章为 Apache 2.0,但仓库元数据为 NOASSERTION)存在不一致,使用前应自行确认许可证状态

安装接入

准备工作

运行环境：Node.js

该仓库不提供单一的即装即用 MCP 服务器,而是提供SDK和多个示例服务器。可通过 npm install -S @modelcontextprotocol/ext-apps 安装SDK用于自建应用;或克隆仓库运行 npm install && npm start 并访问 http://localhost:8080/ 以本地启动参考宿主 basic-host 试用全部示例;每个 Node.js 示例也已发布为独立 npm 包(@modelcontextprotocol/server-<name>),可在支持 stdio 的客户端(如 Claude Desktop、VS Code)中通过 npx -y @modelcontextprotocol/server-<name> --stdio 方式接入。Python 示例(qr-server、say-server)使用 uv run 启动。若使用 AI 编码助手,也可通过 Claude Code 插件市场安装仓库自带的四个 Agent Skills 来生成或迁移 MCP App。

验证是否装好

安装 Agent Skills 后询问代理“你有哪些技能？”，列表中应出现 create-mcp-app、migrate-oai-app、add-app-to-server 和 convert-web-app。

常见排障

确认目标客户端/宿主实际支持 MCP Apps 扩展(参考 modelcontextprotocol.io/clients 列表,因为不同宿主支持程度不同)
为 Node.js 示例服务器接入 stdio 客户端时,确保命令行参数包含 `--stdio`
Python 示例(qr-server、say-server)需使用 `uv run` 启动,而非 npm/node 命令
安装 Agent Skills 后,可向编码助手询问“What skills do you have?”以确认 create-mcp-app、migrate-oai-app、add-app-to-server、convert-web-app 四个技能已生效

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建一个 MCP App
从 OpenAI Apps SDK 迁移到 MCP Apps
为我的 MCP 服务器的工具添加交互式 UI
把我的 Web 应用改造成 MCP App

使用场景

在聊天机器人对话中内嵌交互式图表、表单或仪表盘

将现有 OpenAI Apps SDK 应用迁移到 MCP Apps 协议

为已有 MCP 服务器的工具添加交互式UI

使用官方示例服务器(地图、PDF查看器、二维码生成器等)快速原型验证

详细介绍

modelcontextprotocol 官方仓库,提供 MCP Apps 的协议规范与SDK。MCP Apps 是对核心 Model Context Protocol 的扩展,允许 MCP 服务器在工具定义中声明 ui:// 资源(HTML界面),使宿主(如 Claude、ChatGPT、VS Code 等兼容客户端)能在沙箱化 iframe 中渲染图表、表单、仪表盘等交互式界面,并通过双向通知与工具调用与宿主通信。该仓库本身不是单一可运行的 MCP 服务器,而是打包了协议规范文档、TypeScript SDK(核心库、React hooks、app-bridge、server helpers)、四个用于脚手架/迁移的 Agent Skills,以及约20个示例服务器(地图、3D场景、PDF查看器、二维码生成等)。仓库README展示了 Apache 2.0 许可徽章,但目录元数据标注许可证为 NOASSERTION,两者存在出入,使用前应自行核实许可证条款。