前言¶

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 倉庫。