在使用 DeepSeek Harness 開發智能體時,集成 Model Context Protocol (MCP) 服務器需要頻繁檢查連接狀態和工具列表。直接在配置文件中管理既繁瑣又容易出錯。這個插件通過界面化的方式,解決了這一痛點,讓你能在 Harness 的設置頁面裏直接掃描和管理本地註冊的 MCP 服務器及其工具。
這是一個 DSH 插件,用於在 Harness 的設置頁面中掃描和管理本地註冊的 MCP 服務器及其工具。由 fatefgo2050 維護,採用 MIT 許可證。
核心功能¶
- 可視化列表:在「設置 → MCP 服務器」中列出當前 agent 可見的所有 MCP 服務器與工具。
- 全生命週期管理:支持添加、編輯、刪除、啓停和重連服務器。
- 傳輸協議支持:支持
streamable-http與stdio兩種傳輸方式。 - 工具命名規範:工具統一以
mcp__<serverName>__<tool>格式提供給 agent。 - 宿主掛載處理:識別由 profile 的
cordis.patch.yml掛載的服務器,標記爲「宿主掛載」並設爲只讀,避免重複連接。
安裝與啓用¶
該插件依賴官方公共包 @deepseek-ai/dsh-mcp-client。安裝後需要重啓 DeepSeek Harness 才能生效。
執行以下命令安裝:
dsh plugin --profile desktop add fatefgo2050/dsh-mcp-scanner
典型用法¶
- 打開「設置 → MCP 服務器」。
- 點擊「+ 添加 MCP 服務器」。
- 根據傳輸方式填寫配置:
- streamable-http:填寫 URL,可選 headers(例如
{"Authorization": "Bearer <token>"})。 - stdio:填寫 command + args,可選 env。
- streamable-http:填寫 URL,可選 headers(例如
- 添加後會自動等待連接結果,也可手動點擊「刷新狀態」。
配置存儲¶
- 界面添加:在界面裏添加的服務器會寫入
$DSH_HOME/mcp-servers.json,你可以隨時啓停、編輯或刪除。 - 宿主掛載:通過 profile 的
cordis.patch.yml掛載的服務器顯示爲「宿主掛載」,此處爲只讀模式;如需修改或移除,請直接編輯該配置文件。
安全與注意事項¶
- API 安全:
/mcp-scanner/api/*接口僅對 loopback (127.0.0.1) 開放;當 web 服務器對外暴露時,該 API 會返回 403。 - 命令執行風險:使用
stdio傳輸方式會執行本地命令,請只添加可信來源的服務器。 - 許可證:MIT。
總結¶
這個插件通過圖形界面簡化了 MCP 服務器的接入流程,適合需要在 DSH 中頻繁調試 MCP 工具的開發者。
- 目錄頁:dsh-mcp-scanner
- GitHub 倉庫:fatefgo2050/dsh-mcp-scanner