夜雨聆风学习资料网

ARTICLE · 1379581

DSH插件测评:214 星的 dsh-mcp-apps-host,结果变卡片

DSH插件测评:214 星的 dsh-mcp-apps-host,结果变卡片

AURORA LAB · 前沿观察

DSH插件测评:214 星的 dsh-mcp-apps-host,结果变卡片

214 星、0 个 open issue,提交停在 11-17 的「feat: adapt to DSH 0.2.x」。我先把 oriliz/dsh-mcp-apps-host 拆开看了一遍,结论有点反常识:它渲的不是截图,是真网页——但装完那一刻,它什么都不会做。

01

一、它是什么

dsh-mcp-apps-host 是 oriliz 做的 DSH 插件,包名 @deepseek-ai/dsh-mcp-apps-host,当前 0.2.0 版。它做一件事:把 MCP 服务器里声明了 _meta.ui 的工具结果,渲成对话里的一个沙箱 iframe 卡片。卡片是真正的网页,不是截图;上面的按钮点下去,会经一条桥回到原服务器,再执行一次工具,宿主只负责把它放进沙箱、把调用转给服务器。

2026-11-19 05:01 抓的数:Star 214、fork 3、0 个 open issue、MIT,提交停在 11-17 的「feat: adapt to DSH 0.2.x」。npm 上查不到这个包,仓库也没打 tag,只能从 GitHub 源装。

卡片有两种下发方式:inline 是服务器把 HTML 塞进结果的 _meta.ui.resource.text,跟着结果一起下来;referenced 是工具定义里给一个 ui:// 地址,宿主用 resources/read 取一次再内联。

02

二、装它能少做什么

少抄一次 JSON。 结果不再是满屏花括号,卡片直接渲染成表格或表单。边界:HTML 得 server 作者自己写,插件不替你想界面。

少装一个前端。 卡片跑在宿主给的一次性沙箱里,每张卡独立 CSP,默认放行 https: 图片。边界:只放行该 server 注册的 tool 和 ui:// 资源,file:// 读文件会被拒。

少猜一次上下文。 卡片发起的 tools/call,插件自动注入 session_id;卡片还能用 ui/update-model-context 把上下文写回模型。边界:它只解决「谁在调」,不替你决定调什么。

少一层黑盒。GET /mcp-apps/<serverName>/debug 给你近 64 次桥交换。边界:桥上的调用不进会话 JSONL,要看桥上发生的事只有这个端点。

少一次口头交接。 一个 server 一行实例,各自 serverName,多实例共存。边界:serverName 同时是工具前缀 mcp__<serverName>__* 和桥路径,改名等于换命名空间。

03

三、三个场景

场景一:把自家库存查询接成卡片

你维护一个查库存的 MCP server,同事天天问某个 SKU 还剩多少,以前得让 agent 跑完再把 JSON 抄给人。现在在 profile 的 cordis.patch.yml 里加一段 id: mcp-apps-host 的 override,transport 写 stdio、serverName 写 inventory、command 指向你的 server,重启 dsh web。对话里调它的 tool,结果就带一张能筛能翻的卡片,按钮点下去桥会自动带上 session_id 回调你的服务器。产出:一个不用复制粘贴的查询面板。

场景二:给非工程同事做评审演示

你要让产品同事看内部工具真实长什么样,但不想让他们装环境。做法是让 server 端用 inline 形态把 HTML 塞进结果,你本机起一份干净 profile,用 --patch 挂上 demo overlay,一个 server 一行实例、各自 serverName。演示中谁点了哪个按钮、桥有没有往返,都看 /mcp-apps/<serverName>/debug,近 64 次交换都在。产出:一套能带走复现的 patch 文件,加一段可回放的桥日志。

场景三:运营岗先用 demo 试手

你不写代码,只想确认这卡片到底能不能点。先在仓库里跑 node demo/selftest.mjs,8 项断言,不需要 DSH;再在仓库父目录用 dsh web --patch dsh-mcp-apps-host/demo/mcp-apps-demo.cordis.yml 起 demo overlay。卡片上点按钮,上下文会经 ui/update-model-context 回注给模型,消息再走 ui/message 发回对话。产出:一张能跟模型来回的卡片,和一份能直接交给开发的缺陷清单。

04

四、对比与版本对应

纯文本结果
inline 卡片
referenced 卡片
结果长什么样
一段 JSON 文本
HTML 随结果下发
工具定义里给 ui:// 地址
HTML 谁写
没人写
server 作者塞进 _meta.ui.resource.text
server 作者放进资源
宿主怎么拿
直接读文本
从结果里取
resources/read
 取一次后内联
模型看到什么
全部文本
只看到 structuredContent,看不到 HTML
同左

版本对应:包 0.2.0;README 只写「Built and verified against DSH 0.2.x」,括号里注的是 0.2.2-rc.3。peerDependencies 13 项全是 * 且 optional,意思是「不拦你」,不等于「测过你」——跨大版本自己先跑 node demo/selftest.mjs。运行时依赖 @modelcontextprotocol/sdk ^1.12.0 和 zod ^4.4.3。

05

五、三个坑与三步上手

坑 1:装完没反应。dsh plugin 加完只插入一行 config 为空的 mcp-apps-host,插件是休眠的,日志里会写原因。得去 profile 的 cordis.patch.yml 补一段 id-targeted override,重启才生效。

坑 2:pnpm 拦构建脚本。 从 GitHub 源装会跑 prepare,默认被拦,报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED。把 dsh 打印的键加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 再重跑,或者锁 commit 装。

坑 3:卡片读不到数据。 先看 /debug 有没有往返;有往返但卡片是空的,就是 lastToolResult 形状不对——卡片侧要优先读 meta.lastToolResult.structuredContent。

三步上手:

1. 在仓库里 node demo/selftest.mjs,8 项断言,不用 DSH 也能跑。 2. dsh plugin --profile web add github:oriliz/dsh-mcp-apps-host。 3. 补 override、重启,curl /mcp-apps/<serverName>/debug 确认桥是活的。

写在最后

看到这儿,说明你把它读完了。这类文章能走多远,只取决于两件事:你的在看和转发。

顺手关注并设为星标,下一篇更新第一时间见。

END

一起聊聊

你手上的 MCP 工具,结果现在还是一屏 JSON 吗:你想先把它变成哪个能点的界面?

欢迎在评论区说说你的做法。

乌鸦君疯狂学AI

让天下没有难用的AI

#DSH插件# #MCP应用# #dsh-mcp-apps-host#

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料