dsh-mcp-plus：DSH MCP 服務器圖形化管理插件

前置條件要求 DSH ≥ 0.1.2-alpha.1、Node.js ≥ 18 以及 pnpm ≥ 9。該插件由 sojo-negai 維護，旨在通過 Web 界面簡化 DSH 中 MCP 服務器的配置與監控流程。它支持直接在 DSH 設置頁面編輯 JSON 配置，實時查看連接狀態，並自動完成工具註冊，無需手動修改文件或重啓程序。

核心功能¶

1. 圖形化管理：在 DSH 設置 → 「MCP 服務器」頁直接編輯 JSON 配置，無需手動修改 yml 文件。
2. 實時狀態：每臺服務器顯示一個狀態圓點 —— 🟢 已連接 / 🟡 連接中（閃爍）/ ⚪ 未連接或已禁用。
3. 獨立啓停：每臺服務器支持 enabled 開關，禁用操作不會刪除配置，僅停止連接。
4. 自動重連：保存配置後，插件會自動重連並重新註冊工具，無需重啓 DSH。
5. 格式兼容：直接粘貼 Claude Desktop 風格的 mcpServers JSON 即可導入配置。

安裝與啓用¶

克隆倉庫後，在項目根目錄執行以下命令進行構建和安裝：

pnpm install && pnpm build
node scripts/install.mjs --profile web

安裝完成後，刷新依賴並重啓 DSH 即可使用。

使用流程¶

1. 啓動 DSH，打開 Web 界面。
2. 側邊欄點擊「設置」，頂部 tabs 切換到「MCP 服務器」。
3. 點擊「修改配置(JSON)」，粘貼或編輯服務器配置，點擊「保存」。

配置與狀態說明¶

支持的配置格式¶

插件支持三種配置形態，推薦使用第一種（對象映射），因爲它與 Claude Desktop 的 mcpServers 配置兼容：

{
  "chrome-devtools": {
    "command": "cmd.exe",
    "args": ["/c", "npx", "-y", "chrome-devtools-mcp@latest"],
    "enabled": true
  }
}

狀態指示¶

列表中每臺服務器名字前的圓點表示實時連接狀態：
* 🟢 已連接：工具已註冊，Agent 可調用。
* 🟡 連接中：正在啓動或握手（閃爍狀態），首次冷啓動可能需要較長時間。
* ⚪ 未連接：連接失敗，需檢查 command/args 是否正確，或查看終端日誌。
* ⚪ 已禁用：enabled: false，配置保留但未連接。

工具註冊名¶

配置中定義的服務器名會作爲前綴，工具註冊名格式爲：mcp__<服務器名>__<工具名>。

注意事項¶

• 源碼模式：若使用源碼模式開發，需手動創建 cordis.yml patch 文件將 TS 入口掛進 profile，該文件不入庫。
• 權限：插件以當前 DSH 進程權限運行，請確保配置的命令路徑和環境變量在當前環境中可用。

相關鏈接¶

• GitHub 倉庫
• 技能樹插件目錄