前言¶
在 DeepSeek Harness（DSH）裏使用 MCP 時，常見操作不只包括“能否連接”，還包括查看當前連接狀態、查看工具參數、區分全局與項目作用域、導入已有配置，以及判斷修改後從哪個會話開始生效。
dsh-mcp-manager-ui 面向這些操作提供一個 Web 管理面板：查看 MCP 狀態、展開工具 Schema、添加和編輯 MCP、導入 JSON，並在全局作用域與項目作用域之間切換。
這是什麼¶
dsh-mcp-manager-ui 是 DeepSeek Harness Web 的 MCP 管理面板。GitHub 倉庫地址爲：
https://github.com/Imzl-zl/dsh-mcp-manager-ui
許可證爲：
MIT
它適合已經使用 DSH Web、需要在多個項目之間管理 MCP 的開發者。下面介紹其已覈實的功能、用法和限制。
核心功能¶
查看連接與工具¶
面板可查看 MCP 狀態、傳輸方式、連接參數和工具列表。
展開單個工具可查看完整輸入 JSON Schema，包括必填/可選參數、類型、枚舉、默認值與原始 JSON。
支持按傳輸方式篩選，例如：
HTTP
stdio
也支持按連接狀態篩選，以及按名稱、命令、URL 搜索。
添加、導入與預設¶
添加 MCP 時可套用預設模板，例如：
Filesystem
Memory
Sequential Thinking
“內置 MCP”目錄包括：
Exa
Tavily
Firecrawl
Chrome DevTools
Playwright
可從目錄查看、勾選未配置項並追加。
也支持導入以下配置格式：
mcpServers
servers
mcpServers 常見於 Claude、Cursor、Cline、Roo 等工具；servers 來自 VS Code。
導入時可選擇“合併（同名更新）”或“替換”，寫入前提供預覽。
全局與項目雙作用域¶
全局 MCP 寫入 Web profile 的：
cordis.patch.yml
一次註冊後所有項目可用。寫入時會結構化修改該文件，並保留其他插件條目、註釋和：
!!js
環境變量表達式。
項目級 MCP 寫入項目目錄：
.dsh/mcp.json
僅該項目會話可見。項目標籤頁中可添加、編輯、移除項目級 MCP。
項目還可以“屏蔽”某個全局 MCP，寫入：
exclude
新會話不再看到該 MCP。
保存時會校驗：
serverName
是否唯一，並提示被哪個作用域佔用。
連接字段與生命週期¶
該插件支持 DSH rc.7+ 的完整 MCP 連接字段：
command
args
env
cwd
url
headers
以及調用超時、啓動失敗策略和重連策略。
項目 MCP 由該項目的所有會話共享一份連接，複用：
@deepseek-ai/dsh-mcp-client
支持惰性連接與自動重連。
Host Remote 與 Web 客戶端均隨插件生命週期加載和卸載。
憑據、主題與更新提示¶
面板可顯示並複製已解密的 URL 憑據，以及：
args
env
headers
這些值會話內臨時可見。
面板跟隨 DSH 深色/淺色主題，並適配窄屏和移動寬度。
非強制更新提示：面板打開時 Host 每天最多向 GitHub Releases 查詢一次最新版本。查詢失敗靜默、絕不自動更新；除該查詢外不發送任何數據。可設置環境變量關閉：
DSH_MCP_MANAGER_DISABLE_UPDATE_CHECK
安裝與啓用¶
本文不提供未經覈實的安裝命令。可訪問倉庫查看說明：
https://github.com/Imzl-zl/dsh-mcp-manager-ui
許可證爲：
MIT
安裝前建議檢查源碼、依賴與許可證。該插件會隨 DSH 插件生命週期加載，並以當前 DSH 進程權限運行；安裝前應確認來源與配置目標。
典型用法¶
打開內置 MCP¶
1、打開管理面板。
2、點擊頂部工具欄中位於“導入 JSON”和“添加 MCP”之間的“內置 MCP”。
3、查看目錄，勾選未配置項。
4、一次追加所選 MCP。
全局 MCP 生效¶
全局 MCP 寫入：
cordis.patch.yml
通常 DSH 熱加載立即生效，包括運行中的會話。
項目 MCP 生效¶
項目級 MCP 寫入：
.dsh/mcp.json
下一次新建的連接生效；正在運行的會話不受影響。
若該項目還有會話在跑，新會話複用現有連接，沿用舊配置；等該項目所有會話都結束後，下一個會話纔會用新配置建連。
改完配置不需要點“重連”，也不需要重啓 Host，新開會話即可。
導入已有 MCP 配置¶
1、準備已有配置，例如：
mcpServers
或：
servers
2、在面板中導入。
3、選擇“合併（同名更新）”或“替換”。
4、查看預覽後寫入。
關閉更新提示¶
可在運行 DSH 的環境中設置：
DSH_MCP_MANAGER_DISABLE_UPDATE_CHECK
以關閉非強制更新提示。
配置生效時機¶
全局和項目兩類作用域的生效機制不同：
1、全局作用域寫入：
cordis.patch.yml
通常熱加載後立即生效，運行中會話也可受影響。
2、項目作用域寫入：
.dsh/mcp.json
下一次新建連接生效；正在運行的會話不重讀配置。
3、如果該項目仍有會話在運行，新會話會複用現有連接，沿用舊配置；等所有會話結束後，下一個會話纔會用新配置建連。
4、“屏蔽”全局 MCP 的可見性變更同理，只對之後的會話生效。
已知限制與注意¶
首輪就緒時序¶
項目 MCP 默認異步建連，新會話首輪對話可能還未就緒，第二輪起可用。
若服務器配置了：
failOnStartupError: true
會等待連接確認後才繼續創建會話。
屏蔽不釋放命名¶
“屏蔽”全局 MCP 只隱藏其工具，該：
serverName
的全局實例仍在運行並佔用命名；項目內不能通過同名服務器接管。如需接管，先在全局禁用或移除該服務器。
全局與項目不能同名¶
serverName
在整個進程內唯一；項目級不能與全局或其他項目用同一個名字。保存時會提示被哪個作用域佔用。
手工編輯：
.dsh/mcp.json
或項目不在工作區註冊表裏，可繞過保存路徑校驗；那時第二份連接會啓動失敗。
共享連接與配置粘性¶
運行中連接沿用首會話配置；全部會話結束後，新連接才用新配置。
不支持 per-session 隔離¶
把會話身份綁在連接或進程上的服務器，例如瀏覽器自動化、SSH 會話、編輯器緩衝區、按連接建索引等，在項目作用域下不被支持。
Windows stdio 進程鏈¶
在 Windows 上，忽略 stdin EOF 的 stdio 服務器可能留下孫進程。建議服務器自行處理退出，或改用：
streamable-http
DSH 退出寬限¶
DSH 的退出寬限是 5 秒。同時有多個退得慢的服務器時，退出可能在 teardown 完成前被強行截止。
插件熱重載¶
插件熱重載會清空運行中會話的項目工具。已在運行的會話要重新拿到項目 MCP 工具，需要新開會話。
兼容性¶
已驗證的 DeepSeek Harness 版本爲：
0.1.0-rc.7
及以上，已驗證至：
0.1.0-rc.8
平臺爲 Windows；Linux/macOS 使用同一 DSH Web 契約。
適用對象與風險提示¶
適合：
1、在 DSH Web 中管理多個 MCP 的開發者；
2、需要區分全局 MCP 和項目 MCP 的場景；
3、希望從 Claude、Cursor、Cline、Roo 或 VS Code 導入現有 MCP 配置的場景。
風險：
- 插件會讀取和寫入 MCP 配置，並可顯示已解密憑據，因此應在受信任環境使用。
- 插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
- 許可證爲：
MIT
獲取¶
當前已覈實資料未給出可確認的目錄頁 URL。GitHub 倉庫爲：
https://github.com/Imzl-zl/dsh-mcp-manager-ui
