前言¶

DeepSeek Harness（DSH）通过插件机制扩展功能。管理 MCP（Model Context Protocol）服务器通常需要手动编辑配置文件，这种方式既繁琐又容易出错。mcp-deliverable 作为一个社区 Bundle，为 DSH 的 Web Settings → Plugins 增加了一个可视化的 MCP 服务器管理入口，同时提供了远程控制能力。

这是什么¶

mcp-deliverable 是一个社区维护的、可直接安装到 DeepSeek Harness profile 的 Bundle。由用户 zhuyan1085 维护。它的核心作用是解决 MCP 服务器配置的维护问题，通过 Web 界面和远程控制能力，让配置文件的读写、管理和状态查看变得自动化和原子化。

核心功能¶

该插件提供以下主要能力：

• Host Remote：插件可以读取、原子写入和删除当前 profile 的 MCP 配置。同时，它会显示 Loader 与工具的注册状态，方便调试。
• Web 设置页：提供界面化的编辑功能，支持配置 stdio 与 Streamable HTTP 服务器。可编辑的参数包括参数、环境变量、工作目录、请求头、调用超时、启动失败策略和重连策略。
• 自包含构建：包含自包含的 Typert 描述与浏览器产物。从 GitHub 安装时，它会运行仓库的 prepare 脚本进行构建，不依赖相邻的 Harness 源码检出目录。
• 自动补丁集成：通过 dsh.bundle.patch 机制，自动把插件层加入目标 profile 的 cordis.patch.yml。

安装与启用¶

在安装前，请确保环境满足 Node.js 版本要求（^22.19.0 或 >=24.0.0）。

执行以下命令进行安装：

dsh plugin --profile web add github:zhuyan1085/mcp-deliverable

安装完成后，请重启对应的 profile。

注意：如果使用 pnpm 10 或更高版本，安装时可能会因为构建脚本执行权限问题而失败。安装失败时，请按提示在 profile 的 pnpm-workspace.yaml 中添加对应的 allowBuilds 配置，然后重新执行安装命令。

对于生产环境使用，建议锁定具体的 commit SHA 以确保环境一致性：

dsh plugin --profile web add github:zhuyan1085/mcp-deliverable#COMMIT_SHA

典型用法¶

• 配置管理：插件正常通过 dsh 启动时会自动将配置写入当前 profile 的 cordis.patch.yml。对于嵌入式或测试运行，可以显式指定绝对路径：

    - id: mcp-servers
      config:
        patchFile: /absolute/path/to/cordis.patch.yml

• 本地验证与打包：在一份已安装依赖的 DeepSeek Harness 检出目录旁运行以下命令进行验证和打包：

    DSH_CHECKOUT=/absolute/path/to/deepseek-harness bash scripts/verify.sh
    pnpm run build
    pnpm pack

适用场景与注意¶

• Bundle 优先级：Bundle 层的应用优先于用户自己的 cordis.patch.yml，因此用户仍可按 id: mcp-servers 覆盖或禁用该插件。
• 安全提示：字面量 env 与 headers 值在浏览器中是可读的（需客户端支持可信主机设置）。敏感信息应继续使用环境变量支持的 !!js 表达式，而不是直接写入字面量。
• 许可证：该插件使用 MIT 许可证。

短结尾¶

mcp-deliverable 通过 Web 界面和远程控制能力，简化了 DeepSeek Harness 中 MCP 服务器的配置流程。更多技术细节和更新，请参考 GitHub 仓库。