前言¶
DeepSeek Harness (DSH) 允許智能體通過 MCP (Model Context Protocol) 調用外部工具。但在實際開發中，你往往需要針對不同會話使用不同的 MCP 服務器（例如：一個會話連接數據庫，另一個連接代碼倉庫）。手動管理全局配置和項目配置容易衝突，且無法靈活控制單個會話的可用工具。dsh-mcp-master 解決了這個問題，它將 MCP 服務器的管理下沉到會話級別，並提供了項目與全局配置的統一入口。
插件簡介¶
dsh-mcp-master 是 DeepSeek Harness 的一個工作流插件。由用戶 lastorder 維護。它爲 DSH 提供了一個位於 Composer 行的 MCP 服務器選擇器，支持從全局目錄和項目目錄加載服務器列表，提供 OAuth 認證支持和項目服務器信任審查機制。
核心功能¶
- 會話級選擇器：在每個會話的 Composer 行中顯示
[🔌 MCP 2 ●]。點擊可查看並勾選當前會話啓用的服務器。 - 多目錄管理：支持讀取全局配置
~/.dsh/mcp-master/mcp.json和項目級配置（.mcp.json,.cursor/mcp.json,.vscode/mcp.json,.dsh/mcp.json）。 - 信任審查：項目中的 MCP 服務器必須被信任才能運行。如果服務器被標記爲“未信任”，會顯示具體的命令/URL並提供“Trust & use”按鈕。
- OAuth 認證：支持 MCP 授權規範，可使用 OAuth 提供商動態註冊客戶端進行簽名，Token 存儲在
~/.dsh/mcp-master/state.中。 - 變量解析：支持
${VAR},${workspaceFolder}等環境變量解析。 - 傳輸協議：支持 stdio, Streamable HTTP 和 legacy HTTP。
安裝與啓用¶
該插件通過 DSH 的插件目錄安裝。安裝後，它會生成 cordis.patch.yml 配置文件來注入 Host 和 Client 模塊。
安裝完成後必須重啓 DSH 才能生效。
典型用法¶
- 配置服務器：在項目根目錄創建
.mcp.json，或在全局目錄~/.dsh/mcp-master/mcp.json中編寫mcpServers配置。配置格式遵循 MCP 標準的mcpServers對象。 - 創建會話：打開新會話，Composer 行會出現 MCP 服務器數量指示器。
- 信任項目服務器：如果是首次運行項目中的服務器，點擊狀態點或行中的“Trust & use”按鈕進行授權。
- 切換會話服務器：在會話運行過程中，隨時點擊 Composer 行的 MCP 指示器，勾選或取消勾選服務器，即可在當前會話中註冊/註銷對應工具。
適用場景與注意事項¶
- 適用場景：需要在不同會話間切換不同外部工具鏈的 DSH 用戶；管理多項目環境變量的開發者。
- 注意：項目服務器必須被信任才能運行。OAuth Token 存儲在
~/.dsh/mcp-master/state.中，應視爲敏感憑證文件。日誌和 UI 會自動屏蔽代碼、令牌和 Bearer 值。服務器進程在會話結束後 2 分鐘停止，無會話的工作區在 15 分鐘空閒後關閉。 - 安全：插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
生態背景¶
DSH 理念是「一切皆插件」。本插件收錄自社區目錄，與 DeepSeek 或幻方無官方從屬關係。
