deepseekplugins

DeepSeek Harness 插件

dsh-mcp-apps-creative

Cordis-hosted MCP Apps support for DeepSeek Harness（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
creativedswork/dsh-mcp-apps
最近更新
2026年8月21日
分类
工具与能力
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/creativedswork/dsh-mcp-apps
插件名：dsh-mcp-apps-creative
作者：creativedswork

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.zh-CN.md来源说明 · 只读预览
README 语言

DSH Uni Editor

English | 简体中文

![CI](https://github.com/creativedswork/dsh-uni-editor/actions/workflows/ci.yml) ![npm](https://www.npmjs.com/package/@creative-dswork/dsh-uni-editor) ![GitHub release](https://github.com/creativedswork/dsh-uni-editor/releases) ![license](LICENSE)

所有 Editor，一个 DSH Editor。

DSH Uni Editor 将现有 Editor 接入 DeepSeek Harness Agent Chat。Editor 保留自己的 UI、数据模型和领域工具；DSH 统一入口、当前 Session 上下文，以及人工编辑与 Agent 之间可验证的交接。

它是一个基于稳定版 MCP Apps 的 Cordis 插件包。一个 npm 包同时提供 Host 插件、Browser bundle，以及用于启用两者的 dsh.bundle patch。

Host 管理 MCP 连接，通过 Harness 注册模型可见工具，不把 app-only 工具暴露给模型，并通过不同源的 Sandbox Proxy 运行不受信任的 View。整个方案不需要修改 Agent Loop，也不需要外部 MCP 代理。

<a href="https://www.youtube.com/watch?v=KkvLgN2GeTI"> <img width="900" alt="观看 DSH Chat UI 与 Three.js Editor MCP App 视频演示" src="https://i.ytimg.com/vi/KkvLgN2GeTI/maxresdefault.jpg"> </a>

观看视频演示，了解 threejs-editor-mcp 如何直接运行在 DSH Chat UI 中。Editor 始终可以从 Session Header 返回；inline 与 fullscreen 切换不会重建 iframe，并可通过 Locate in Chat 返回产生该 App 的工具消息。

安装

将 npm 包安装到 Web profile：

dsh plugin --profile web add @creative-dswork/dsh-uni-editor

安装后 bundle 会自动启用。在 $DSH_HOME/profiles/web/cordis.patch.yml 中配置 mcp-apps：

- id: mcp-apps
  config:
    servers:
      - serverName: counter
        transport: stdio
        command: node
        args: [/absolute/path/to/server.js]
        cwd: /absolute/path/to/server
        forwardWorkspace: true

forwardWorkspace 默认关闭，只应对需要当前 DSH Workspace 的可信本地 stdio Server 启用。transport: streamable-http 不会收到 Workspace metadata；此时改为 提供 url 和可选的 headers，不再填写 command、args、cwd 和 env。 serverName 必须匹配 [A-Za-z0-9_-]{1,32}，它会成为公开工具名的一部分。

启动 Harness：

dsh web

Web profile 必须绑定到 127.0.0.1。当前 Sandbox Proxy 只支持 loopback 浏览器，因此插件会拒绝范围更大的监听地址。

独立 Counter Demo

仓库内置了一个本地 stdio MCP Server：

  • show_counter：模型可见工具，关联 ui://counter/app；
  • increment_counter：只有该 View 可以调用的 app-only 工具；
  • 一个使用 MCP Apps 官方 App 的内置 View。

下面的命令使用已发布的 Harness CLI，不依赖相邻的 deepseek-harness 源码目录：

pnpm install
pnpm run build
export DSH_HOME="$PWD/.tmp/demo-home"
pnpm dlx @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add "$PWD"
pnpm dlx @deepseek-ai/dsh@0.1.0-rc.6 web --patch "$PWD/demo/cordis.patch.yml"

打开命令输出的 URL，将当前目录连接为 workspace，然后让已配置的模型显示 counter。工具调用完成后，工具卡片会渲染数值 0；点击 + 时，View 会通过 Host 调用 app-only 的 increment_counter，并把数值更新为 1。

完整编辑器示例请参阅 threejs-editor-mcp。

行为

  • 目标规范为 MCP Apps 2026-01-26，View MIME 类型为 text/html;profile=mcp-app。
  • 支持 stdio 和 Streamable HTTP 两种 MCP transport。
  • 识别 _meta.ui.visibility；省略该字段时，工具同时对模型和 App 可见。
  • 对设置 forwardWorkspace: true 的可信本地 stdio Server，将调用 Agent

不可变的 Workspace cwd 写入模型发起的 tools/call request metadata ai.deepseek.dsh/workspace。远程 HTTP、App 发起的调用以及模型可见的 tool 参数和结果都不包含该值。

  • 将可读文本交给模型，同时把 structuredContent 和结果 _meta 保存在受大小限制、仅 UI 可见的 presentation metadata 中。
  • 使用官方 AppBridge 和 PostMessageTransport 处理 View 生命周期，以及 App 发起的工具和资源调用。
  • 在 Session Header 中提供持续可见的 Active App 入口，并支持多个 MCP App Instance。
  • 打开 fullscreen 时不重建 iframe 或 AppBridge，保留 View 中尚未保存的状态。
  • 通过 Locate in Chat 返回产生该 App 的原始工具消息。
  • 代理 ui/download-file，允许下载一个最大 4 MiB 的内嵌 JSON 资源，因为 Sandbox View 无法直接下载文件。
  • 在独立 loopback origin 上通过 HTTP header 强制执行 CSP，并校验 postMessage 的 source 和 origin。
  • View 加载失败时回退到普通文本工具结果。

工具列表变化会自动同步；transport 自动重连尚未实现。Browser 每五秒刷新一次 catalog。

安全架构

flowchart LR
  Agent["Harness Agent"] -->|"模型可见工具"| Host["MCP Apps Host<br/>127.0.0.1"]
  Host -->|"stdio 或 Streamable HTTP"| Server["MCP Server"]

  subgraph Browser["浏览器"]
    UI["Harness UI<br/>Host origin"]
    Proxy["Sandbox Proxy<br/>独立 loopback origin"]
    View["MCP App View<br/>双层 iframe Sandbox"]
    UI -->|"经过校验的 postMessage"| Proxy
    Proxy -->|"CSP + sandbox 属性"| View
  end

  Host -->|"受大小限制的 View 和资源 API"| UI
  View -->|"app-only 工具和 ui/message"| UI
  UI -->|"经过授权的 bridge 调用"| Host
  • Host 和 Sandbox Proxy 使用不同的 loopback origin。
  • View 运行在双层 iframe 中，由 HTTP CSP 和明确的 sandbox 属性共同约束。
  • bridge 接受消息前会校验 postMessage 的 source 和 origin。
  • 工具可见性将模型可见工具与 app-only 工具分开。
  • Host API 拒绝跨源写入，并限制请求体和 metadata 的大小。

开发

pnpm install
pnpm run check
pnpm run pack:dry-run

将本地 checkout 安装到 profile：

dsh plugin --profile web add .
dsh --profile web --dump-config

发布

prepack 会执行类型检查、生产构建和包测试。npm tarball 包含 Host 入口、Browser bundle、类型声明、bundle patch、许可证和中英文 README，不包含开发 Demo 文件。

发布通过 Publish workflow 手动触发。npm environment 必须提供有权发布 @creative-dswork scope 的 NPM_TOKEN。workflow 会携带 provenance 发布 npm 包；npm 发布成功后，再创建对应版本的 tag 和 GitHub Release。

0.2.0 及更早版本以 @creative-dswork/dsh-mcp-apps 发布。当前版本请安装 @creative-dswork/dsh-uni-editor。

返回搜索打开 GitHub 仓库

更多相关插件

查看分类