sugarforever/dsh-mcp-apps

支持MCP应用的DeepSeek插件

Project Overview项目介绍

This is a native Cordis plugin for DeepSeek Harness that turns DSH into an MCP Apps host. It has two core functional components: the host half connects to an MCP server, registers the server’s model-visible tools to DSH’s context tools, and handles all MCP network or stdio traffic. The web client half renders tools that carry UI metadata as sandboxed interactive apps embedded directly inside DSH conversation threads. It supports the full MCP Apps spec, including extension negotiation, multiple transport types, and structured content delivery from the server to the view.

To install the plugin, you first need to set up DSH with the required Node.js version (^22.19.0 or >=24.0.0) and install pnpm 11.7.0 globally as required by DSH’s plugin manager. Then you can run the DSH plugin add command to install the published npm package, a local development checkout, or a downloaded release tarball into your DSH web profile. By default, the plugin installs a configuration that mounts the public VibeFun MCP Apps server, but you can edit the profile patch to connect any custom MCP server that supports the MCP Apps spec. This plugin is intended for developers who want to run interactive MCP Apps directly inside their DSH workflow.

The plugin is released under the open source MIT license, so it is free to use and modify for any purpose. It has several documented current limitations: one plugin instance can only connect to one MCP server, so you need to mount multiple instances for multiple servers. UI tool discovery only runs when the plugin activates, so any changes to the MCP server’s tool list require a plugin reload or client refresh. Headless and ACP entry points do not support embedded app surfaces, even though they still receive the MCP tools. App developers must include all required CSP metadata for remote resources if their app uses external assets.

这是一个专为 DeepSeek Harness(DSH)开发的原生 Cordis 插件,作用是让 DSH 成为 MCP 应用宿主。插件分为两个功能部分,宿主端连接 MCP 服务器,将服务器提供的工具注册为 DSH 可用工具,处理所有 MCP 网络和标准输入输出流量;网页客户端部分会将携带 UI 资源的工具渲染为对话中的沙盒交互式应用。

该插件支持 MCP 应用扩展协商、stdio 和 Streamable HTTP 两种 MCP 传输方式、不同可见性的工具调用,兼容新旧版本的 UI 资源定义规范。开发者安装后可以通过修改配置文件接入自定义的 MCP 服务器,默认安装后会自动挂载公共的 VibeFun MCP 应用服务器,适合需要在 DSH 对话中集成交互式 MCP 应用的开发者使用。

该插件采用 MIT 许可开源免费使用,运行依赖 Node.js 22.19.0 以上版本,需要配合 pnpm 包管理器使用。当前存在一些限制,比如一个插件实例仅能连接一个 MCP 服务器,UI 工具发现仅在插件激活时执行,无嵌入式应用界面的入口不支持显示应用,需要开发者注意这些限制。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

npx @deepseek-ai/dsh plugin --profile web add @sugarforever/dsh-mcp-apps

把 sugarforever/dsh-mcp-apps 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DeepSeek Harness MCP Apps

@sugarforever/dsh-mcp-apps is a dual-face Cordis plugin that makes DeepSeek Harness an MCP Apps host.

The Host half connects to one MCP Server, registers its model-visible tools on ctx.tools, and owns all MCP network or stdio traffic. The Web Client half renders tools carrying _meta.ui.resourceUri as sandboxed interactive Apps inside the Harness conversation.

What it supports

  • MCP Apps extension negotiation: io.modelcontextprotocol/ui
  • text/html;profile=mcp-app UI resources
  • Modern _meta.ui.resourceUri and legacy _meta["ui/resourceUri"]
  • stdio and Streamable HTTP MCP transports
  • Model-visible, App-visible, and App-only tools
  • Original CallToolResult delivery to the View, including structuredContent
  • View-to-Server tools/call, resources/list, and resources/read
  • Resource CSP metadata and iframe Permission Policy requests
  • Cordis lifecycle disposal for tools, connections, RPC routes, Slots, and App bridges

Plain MCP tools remain plain Harness tools. An MCP Server does not need to provide a UI for every tool.

Install DeepSeek Harness

DeepSeek Harness currently requires Node.js ^22.19.0 or >=24.0.0. Its profile plugin manager also invokes pnpm; install the version used by the current DSH release:

npm install --global pnpm@11.7.0

Then start the Web profile without a global DSH installation:

npx @deepseek-ai/dsh web

The Web UI is served at http://127.0.0.1:3080 by default. The first run initializes the web profile under ~/.dsh/profiles/web (or $DSH_HOME/profiles/web when DSH_HOME is set).

Install the plugin

Install the published package into the DSH Web profile:

npx @deepseek-ai/dsh plugin --profile web add @sugarforever/dsh-mcp-apps

For local development, install this checkout instead:

npx @deepseek-ai/dsh plugin --profile web add /absolute/path/to/dsh-mcp-apps

You can also install a tarball downloaded from a GitHub Release:

npx @deepseek-ai/dsh plugin --profile web add ./sugarforever-dsh-mcp-apps-0.1.2.tgz

The package is a DSH bundle. Installing it also applies its bundled cordis.patch.yml, which mounts the public VibeFun MCP Apps server at https://vibefun.app/api/mcp by default.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-codebuddy-cli 下一个 Next dsh-llm-ollama →