前言¶
DeepSeek Harness (DSH) 採用了插件化架構，但在實際開發中，管理 MCP 服務器往往面臨配置分散、連接狀態不透明、工具調用難以追蹤等痛點。現有的方式可能需要重啓進程或依賴外部工具。dsh-mcp-studio 將這些功能集成到 DSH 的設置頁面中，提供了一個無需重啓即可生效的 MCP 服務器工作臺。
是什麼¶
dsh-mcp-studio 是 DeepSeek Harness (DSH) 的 MCP 服務器工作臺，由 SeaOf0 維護。它解決的核心問題是：如何在 DSH 環境中實時掛載、監控和管理 MCP 服務器，以及如何便捷地導入和導出配置。
核心功能¶
-
實時掛載與熱切換
每個啓用的服務器由內置的@deepseek-ai/dsh-mcp-client橋接掛載。模型可以直接調用mcp__<名稱>__<工具>。編輯配置即可熱切換，禁用或刪除會自動卸載。 -
真實連接狀態
狀態直接聚合自 DSH 工具註冊表（ctx.tools.view()）。顯示狀態包括：已連接、啓動中、未連接、失敗（含錯誤詳情）、已禁用。連接中會有脈衝呼吸燈效果。 -
工具預覽浮層
點擊“N 個工具”徽章彈出獨立浮層，展示服務器名、工具總數及簡介。支持即時篩選。浮層會自動適配視口（上下翻轉、高度鉗制、滾動跟隨）。 -
工具調用監控
訂閱會話事件流，記錄每次調用的服務器、工具、耗時和成敗。使用內存環形緩衝，容量 200 條，按 20 條/頁翻頁，支持按服務器篩選、兩步確認一鍵清空，重啓即清零。 -
連接診斷
一鍵發起獨立的 MCP 握手（支持 stdio 臨時子進程和 streamable-http 直連）。展示握手耗時、協商協議版本、服務器信息和工具數量。 -
JSON 一鍵導入
兼容 Claude Desktop、VS Code、Cline/Roo（含 disabled）等多種格式的配置文件。支持裸映射、無包裝單對象、多層包裝。自動識別 stdio/http、env/headers，重名會自動加後綴。 -
模板庫
內置 9 個常用服務器預設：Everything、Filesystem、Fetch、Memory、Seq Thinking、Puppeteer、GitHub、Chrome DevTools、HTTP 示例。 -
配置導出
支持將當前全部配置或單臺服務器一鍵複製爲mcpServersJSON 格式。 -
排序與篩選
支持卡片拖拽排序（保存持久化）、按名稱/命令/URL 搜索、四態狀態篩選，以及緊湊/舒適密度切換。 -
設計
使用--dsw-alias-*主題令牌，明暗皮膚自適應。通過字號、間距和狀態色表達層級，全程零 emoji 和零圖標裝飾。
安裝與啓用¶
前置條件：
* DeepSeek Harness (DSH) 版本 >= 0.1.0-rc.6
* Node.js 版本 >= 22.19 或 >= 24
安裝命令：
npx @deepseek-ai/dsh plugin --profile web add github:SeaOf0/dsh-mcp-studio
安裝後，重啓 dsh web，在設置對話框中會出現 MCP 工作臺（位於側邊卡片之下）。配置持久化保存在 ~/.dsh/settings.yaml 的 mcp-studio 段。
典型用法¶
- 添加或導入配置：點擊“添加服務器”手動配置，或點擊“粘貼 JSON”導入（抽屜內帶有模板和格式化按鈕）。也可以點擊預設芯片一鍵填入。
- 對話調用：在對話中直接指令模型使用特定服務器，例如“用 github 服務器查一下 xxx 倉庫”，模型會自動調用
mcp__github__*工具。 - 查看狀態：統計條實時顯示服務器、已啓用、已連接及工具總數。卡片狀態燈爲綠色呼吸燈表示已連接。
- 診斷與調試：點擊“N 個工具”徽章查看詳情，或點擊“測試連接”運行獨立握手以查看協議版本和耗時。
適用場景與注意¶
適用於需要深度管理 MCP 服務器連接、工具調用情況及配置的 DSH 用戶和開發者。
注意事項：
* 插件以當前 DSH 進程權限運行。
* 需確保宿主包已 external 化，運行時依賴從 ~/.dsh/profiles/node_modules 解析。
* 安裝前建議檢查源碼與許可證。
結尾¶
dsh-mcp-studio 通過在設置頁內集成掛載、監控、診斷和導入導出功能，解決了 MCP 服務器管理碎片化的問題。它通過熱切換和持久化配置，降低了管理複雜度。
