前言¶
如果你在 DeepSeek Harness(下文簡稱 DSH)裏配過幾個 MCP 服務器,大概熟悉這套流程:手動編輯 profile 的 cordis.patch.yml,重啓 DSH,然後祈禱它連上了。至於服務器到底註冊了哪些工具、pip 裝的 stdio 服務器是不是有新版本,都沒有一個地方能看到,只能翻日誌或者去試。
jinhongxun/dsh-mcphub 解決的就是這個問題:它在 DSH 的設置面板裏新增一個 MCP 分區,把連接狀態、版本升級、添加服務器、連通測試這幾件事搬到了界面上。下面介紹它的功能、安裝方法和使用注意。
這是什麼¶
dsh-mcphub 是一個 DSH 插件,由 jinhongxun 維護,許可證爲 MIT,寫作時版本爲 0.3.1。它通過 DSH 的客戶端注入機制(package.json 中 dsh.client.platform 爲 web)在設置面板中掛載 MCP 分區,所有對 MCP 配置的查看和改動都在瀏覽器面板裏完成。
核心功能¶
連接狀態¶
分區裏列出當前 profile 的所有 MCP 服務器,每個服務器一個狀態點:
- 綠點:該服務器的工具已註冊進當前會話,AI 可以調用;
- 灰點:已配置但未註冊工具。
同時顯示傳輸類型(stdio / HTTP)、目標地址、工具數量與樣例。
狀態點不是插件自己維護的:插件讀取運行中的工具註冊表,某服務器存在 mcp__<服務器名>__* 形式的工具註冊即視爲已連接。這樣做零侵入,狀態永遠和真實能力一致;邊界情況是「已連接但暴露 0 個工具」的服務器會顯示爲灰點。
升級管理¶
按服務器類型分三種處理:
- pip 安裝的 stdio 服務器(如 scrapling):自動比對 PyPI 最新版,有新版時顯示「可升級」徽標,一鍵執行
pip install --upgrade。Windows 下的文件鎖問題已處理:先停掉佔用進程,暫存舊 exe,失敗時恢復。 - npx 型服務器:比對 npx 緩存中的實際版本,提供「刷新緩存」操作。
@latest型規格:每次啓動自動拉最新,插件不做重複提示。
添加服務器¶
表單錄入 serverName / transport,以及 URL+headers(HTTP 型)或 command+args+env(stdio 型),追加寫入對應 profile 的 cordis.patch.yml,重啓 DSH 後生效。不想用表單的也可以手動編輯配置,面板的使用說明裏附有示例。
連通測試¶
- HTTP 服務器:發送真實的 MCP
initialize握手,顯示對方 serverInfo 與耗時; - stdio 服務器:校驗可執行文件是否存在。
使用說明與隱私¶
面板內置使用文檔,覆蓋工具命名規則、如何讓 AI 調用工具、手動編輯配置示例、密鑰安全提醒和排障指引。
隱私方面值得單獨說一句:配置文件裏的 headers / env 密鑰只在 Host 進程內存中用於探測握手,永遠不會發送到瀏覽器端,面板只收到鍵名。
安裝與啓用¶
環境要求:Node.js ≥ 20,以及帶 dsh-client-connection 通道的 DeepSeek Harness(官方發行版自帶)。
安裝命令:
# 從 GitHub
dsh plugin --profile web add github:jinhongxun/dsh-mcphub
# 或從 npm(如已發佈)
dsh plugin --profile web add dsh-mcphub
npm 安裝方式在 README 中標註爲「如已發佈」,是否已實際上架 npm 無法從現有資料確認,建議優先用 GitHub 方式安裝。安裝後需重啓 DSH 生效。
典型用法¶
讓 AI 調用 MCP 工具。DSH 中 MCP 工具的命名格式是:
mcp__<服務器名>__<工具名>
綠點的服務器,其工具已註冊進會話,直接在對話裏讓 AI 調用即可。
理解 profile。profile 是 DSH 的「獨立配置環境」,類似瀏覽器的多用戶配置:每個 profile 有自己的插件和 MCP 列表,互不影響。比如一臺機器上可以有 web(日常網頁版)和 open-design 兩套,各配各的 MCP。添加服務器表單裏的 profile 選擇決定寫入哪套環境的 cordis.patch.yml——只有一個 profile 時無需關心這一項。
改動生效時機。所有配置改動(新增、暫停、刪除、升級)都需要重啓 DSH 後生效,面板上的操作只是改配置,不會熱加載。
適用場景與注意¶
適合的場景:
- 配了多個 MCP 服務器,想知道哪個真正連上了、註冊了哪些工具;
- 常用 pip / npx 安裝的 stdio 服務器,需要跟蹤版本升級;
- 不想手改 YAML,希望用表單添加服務器並順帶驗證連通性。
幾點注意:
- 兼容 Windows / macOS / Linux。升級動作按平臺分流:PowerShell ↔ pkill、
where↔command -v、npm 緩存路徑自動探測。 - README 的截圖部分標註「待補充」,目前以文字描述爲主。
- 安全提醒:插件以當前 dsh 進程的權限運行,安裝第三方插件前建議先查看其源碼與許可證。本插件源碼在 GitHub 公開,許可證爲 MIT(README 與 package.json 一致)。
結尾¶
dsh-mcphub 做的事不復雜:把 DSH 裏 MCP 配置的「看狀態、升版本、加服務器、測連通」收進設置面板,並且不自己維護狀態,直接讀運行中的工具註冊表。如果你在 DSH 裏用的 MCP 服務器不止一兩個,裝上它能省不少翻配置文件的時間。
- GitHub:https://github.com/jinhongxun/dsh-mcphub
- 插件目錄頁:https://www.skillhub.cn/plugins/jinhongxun/dsh-mcphub (社區維護的獨立目錄,與 DeepSeek / 幻方無官方從屬關係)