ARTICLE · 1379581
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 拆开看了一遍,结论有点反常识:它渲的不是截图,是真网页——但装完那一刻,它什么都不会做。
一、它是什么
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 取一次再内联。

二、装它能少做什么
少抄一次 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>__* 和桥路径,改名等于换命名空间。
三、三个场景
场景一:把自家库存查询接成卡片
你维护一个查库存的 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 发回对话。产出:一张能跟模型来回的卡片,和一份能直接交给开发的缺陷清单。

四、对比与版本对应
| resources/read | |||
版本对应:包 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。

五、三个坑与三步上手
坑 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#















































































