前言¶
DeepSeek Harness (DSH) 採用插件化架構，管理 Model Context Protocol (MCP) 服務器通常需要直接編輯配置文件。dsh-mcp-ui 提供了一個可視化的 Web 設置卡片，允許用戶在 DSH 界面中管理 MCP 服務器配置，替代手動編輯 settings.yaml。
插件定位¶
dsh-mcp-ui 是 DeepSeek Harness 的客戶端插件，由 quan-v 維護。它負責提供設置卡片 UI、存儲配置信息，並監聽配置變化以自動管理 dsh-mcp-client 實例的掛載與卸載，無需用戶重啓 DSH 進程。
核心能力¶
- Settings card UI：在 DSH Web 設置中提供 MCP 服務器配置卡片，與其它 DSH 插件樣式保持一致。
- 雙傳輸支持：同時支持 stdio（本地進程）和 streamable-http（遠程 URL）兩種傳輸方式。
- 全字段覆蓋：支持完整的配置項，包括
serverName、command/args/env/cwd、url/headers、tool-call timeout、startup-failure policy以及auto-reconnect（開啓/延遲/上限/嘗試次數）。 - Hot sync：保存配置時，主機側會自動掛載或卸載對應的
dsh-mcp-client實例，無需重啓 DSH。 - Safe：服務器列表存儲在
~/.dsh/settings.yaml中，敏感信息通過環境變量引用。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add github:quan-v/dsh-mcp-ui
安裝完成後重啓 dsh web，在 Settings > Plugins > Plugin Config > MCP Servers 下即可找到該設置卡片。
使用方法¶
- 打開設置卡片，點擊 + Add Server。
- 填寫唯一的
serverName（模型調用的工具命名格式爲mcp__<serverName>__<tool>）。 - 選擇傳輸方式（stdio 或 streamable-http）並填寫對應的字段。
- 點擊 Save，主機自動建立連接，服務器提供的工具即可被模型調用。
注意事項¶
- 該插件不實現 MCP 協議本身，僅提供設置卡片和配置存儲功能。
- 它通過監聽配置變化，利用
ctx.plugin()在主機側掛載或卸載官方dsh-mcp-client實例，實際的連接建立、工具發現和命名由官方客戶端處理。 - DSH 0.1.1+ 版本要求帶鍵的槽位，插件已適配此要求（版本 1.0.1 中修復了缺少
options.key的問題）。 - 配置文件以
mcp-ui:爲鍵存儲在~/.dsh/settings.yaml中。
結語¶
dsh-mcp-ui 通過可視化界面簡化了 MCP 服務器的配置流程，適合需要在 DSH Web 界面快速調整服務器參數的開發者。更多詳情可訪問 GitHub 倉庫。
