MCP应用降级兼容核验工作流

MCP应用降级兼容核验工作流

3个实用技能 · 3步完成 · 每一步都能单独使用

检查 MCP Apps 的 UI 能力协商、工具 UI 元数据、text-only fallback、meaningful content 和 app-only 工具可见性，在宿主不支持 UI 时给出可复核的降级结果；只处理脱敏本地 JSON，不连接 MCP 宿主或真实工具。

3个可下载技能 · 每个技能可单独运行

3步自动化工作流

🔵 1 UI能力与工具元数据探测

技能文件：mcp-app-capability-fallback-probe

解决什么： 检查宿主是否声明 UI 扩展能力、UI 工具是否引用合法 ui:// 资源，并统计 UI 工具。

你会得到： READY/REVIEW 报告、能力摘要、UI 工具数、缺口列表和 probe_hash。

↓ 本步结果自动进入下一步

🟢 2 文本降级与可见性检查

技能文件：mcp-app-text-fallback-check

解决什么： 检查 UI 工具是否有 text-only fallback、返回是否有 meaningful content，并列出 app-only 工具。

你会得到： READY/HOLD 报告、content 数量、app-only 工具清单、缺口列表和 fallback_hash。

↓ 本步结果自动进入下一步

🟠 3 应用降级闸门

技能文件：mcp-app-degradation-gate

解决什么： 汇总能力与 fallback 检查，输出 UI_READY_WITH_TEXT_FALLBACK 或 HOLD，确保 app-only 工具不被模型上下文误用。

你会得到： 可复核的降级准入结论、阻断原因、哈希和 network_request_executed=false；不执行工具调用。

↓ 本步结果形成最终交付

实际示例

脱敏样例模拟一个支持 UI 的宿主：工具引用 ui://weather/dashboard，同时提供 text-only 结果和有意义的 content，另有一个只对 app 可见的刷新工具；三步输出 UI_READY_WITH_TEXT_FALLBACK。缺少 text fallback 或 content 为空时输出 HOLD。这是本地测试情境，不冒充真实客户成果。

适合谁

• 使用 MCP Apps、ChatGPT/Claude 类嵌入式工具界面的开发团队

• 需要让不支持 UI 的宿主仍能安全使用工具的 MCP 服务作者

• 维护 UI 资源、工具 visibility 和多宿主兼容测试的工程师

• 交付 MCP 接入、工具网关和 Agent 生产验收的自动化服务商

买家只需提供

• 脱敏的 client capabilities、tools/list 和工具 _meta.ui JSON

• UI-enabled 工具的 text-only fallback 与 content 示例

• app-only 工具清单和宿主不支持 UI 时的处理边界

使用方式

1. 使用 Python 3.10 或更高版本，在隔离目录保存脱敏 JSON，不放密码、Cookie、令牌或真实客户数据。

2. 依次运行能力探测、文本降级检查和应用降级闸门；每个技能也可单独运行。

3. 在测试夹具上验收后，再由买家自己的 MCP 宿主、SDK 和工具网关进行真实联调。

交付与验收

• 三个独立技能目录，每个包含 _meta.json、SKILL.md、README.md、标准库脚本、agents 配置和脱敏示例。

• 完整夹具必须输出 READY、fallback READY 和 UI_READY_WITH_TEXT_FALLBACK；缺少能力、fallback 或 meaningful content 必须 REVIEW/HOLD。

• app-only 工具必须被记录且不会被模型可见性误判；全程 model_visible_app_only_tools=false。

• 不包含 MCP 宿主、UI iframe、SDK、浏览器、真实网络调用、账号、密钥、人工验收或外部动作执行。

服务说明

本套餐是离线降级和可见性核验工具，不替代 MCP Apps 规范、SDK 联调、iframe 沙箱或真实权限测试。结构上存在 text fallback 不代表业务内容完整，也不代表宿主真的支持该 UI 版本。套餐不承诺零错误、绝对兼容、绝对合规、收入或固定节省比例。