前言¶
DSH(DeepSeek Harness)採用插件化架構。在使用 DSH 進行智能體開發時,管理 MCP(Model Context Protocol)服務器通常需要手動配置或依賴全局設置。dsh-project-mcp-manager 擴展了原版 DSH 代碼,在項目層和用戶層提供了更完整的 MCP 管理能力。
是什麼¶
這是一個基於原版 DSH 代碼擴展的插件,由 wldxiaobai 維護。它的核心作用是解決多項目環境下的 MCP 配置分散問題,允許開發者將 MCP 服務器配置寫入項目目錄,並在會話啓動時自動加載。
核心功能¶
該插件提供了以下核心能力:
* 項目級 MCP 自動加載:在項目根目錄下創建配置文件即可自動掛載。
* 配置文件支持:支持 .dsh/mcp.yml、.dsh/mcp.(json) 以及只讀的 .mcp.json。
* 配置熱重載:修改配置文件後,DSH 進程會自動重新加載,無需重啓。
* 工具可見性作用域:工具的可見性基於會話的當前工作目錄(CWD)進行隔離。
* CLI 工具:提供 dsh-mcp 命令行工具用於寫入配置。
* 多層級配置源:支持多層級配置覆蓋。
* 官方通信:使用官方 @deepseek-ai/dsh-mcp-client 進行通信。
安裝與啓用¶
插件通過 Bundle Patch 的方式掛載。在安裝前請確保已安裝 DSH。
前置要求¶
- 安裝 DSH:
npm install -g @deepseek-ai/dsh(或其他源)。
安裝步驟¶
使用官方推薦命令安裝最新版本:
dsh plugin --profile web add dsh-project-mcp-manager@latest
版本兼容性說明¶
- v0.7.x:需要 DSH 版本
>= 0.2.0-rc.2。 - v0.6.0:如果使用 DSH
0.1.5,請使用此版本。
典型用法¶
1. 創建配置文件¶
在項目根目錄下創建 .dsh/mcp.yml 文件,並寫入 MCP 服務器配置。
2. 使用 CLI 工具¶
插件提供了 dsh-mcp CLI 工具來管理配置。
注意事項¶
- 無 UI:該插件僅提供核心功能,沒有圖形界面。
- 配置機制:官方配置是基於 profile-layer Cordis patch 加上
plugin_manager。 - 傳輸類型:MCP 傳輸類型由官方客戶端決定,該插件不負責底層傳輸。
結尾¶
該插件通過項目級配置文件和熱重載機制,簡化了在多項目場景下管理 MCP 服務器的流程。更多細節請參考項目文檔或源碼。
GitHub 倉庫