dsh-mcp-manager

<b style="font-size: 1.15em;">MCP 可视化管理器：装没装、连没连，一目了然</b><br /><br /> <code>查看列表</code> <code>新增删除</code> <code>启用停用</code> <code>连接状态</code> <code>连接测试</code> <code>中英双语</code><br /> <code>DeepSeek Harness</code> <code>DSH Desktop</code><br /><br /> <b>设置 → MCP</b> 一站管理 DeepSeek Harness 里的所有 MCP 服务器，<br /> 无需再手改 <code>cordis.patch.yml</code> —— 所有修改即改即生效（HMR 热应用）。

🌏 <a href="./README.md"><b>中文</b></a> · <a href="./README_EN.md">English</a>

✨ 功能一览

• 📋 服务器列表：列出所有已安装/启用的 MCP 服务器（@deepseek-ai/dsh-mcp-client 实例）——serverName、传输方式（stdio / streamable-http）、URL / 命令、启用状态、加载阶段、已注册工具数
• ➕ 新增 / ➖ 删除：表单添加 MCP 服务器（stdio 与 streamable-http，支持 env / headers / args / 超时 / failOnStartupError），带格式与重名校验；一键删除
• 🔌 启用 / 停用：随时切换，工具随之热连接 / 热断开
• 📶 连接状态：每台服务器实时状态胶囊（Connected · N tools / Failed / Loading / Disabled）+ 独立 Test 探测（initialize + tools/list，报告延迟与工具数）
• ✏️ 编辑：在被编辑卡片原位展开表单，保存即应用
• 🌏 多语言：界面文案跟随 DSH 语言（zh / en）实时切换
• 💾 持久化：所有修改写入 profile 的 cordis.patch.yml，重启后保留；页面底部显示文件路径

🚀 安装

插件已收录至 dsh-market 与 dsh-plugin-marketplace。

前置：DSH 已装好（dsh web 能正常运行）。

方式一 · AI Agent 安装

告诉 Agent：「请安装 dsh-mcp-manager 插件，插件仓库是 https://github.com/Js2Hou/dsh-mcp-manager」

方式二 · 插件市场安装（推荐）

任选一个插件市场：

• DSH Desktop（社区桌面版）：内置插件市场，选 DSH 1024Store 或 dshfind 源，搜索 js2hou/dsh-mcp-manager 安装（同名插件较多，认准作者 Js2Hou）；
• dsh-market：搜索 js2hou/dsh-mcp-manager 一键安装；
• dsh-plugin-marketplace：搜索 js2hou/dsh-mcp-manager 一键安装。

方式三 · dsh 命令安装

dsh plugin --profile web add @js2hou/dsh-mcp-manager

也可 GitHub 源安装（构建产物 lib/ 已入库，无需本地构建）：

dsh plugin --profile web add github:Js2Hou/dsh-mcp-manager

<b>脚本安装</b>（一键脚本安装：自动处理新版放行与残留清理，幂等）

macOS / Linux（Windows 装了 Git Bash 或 WSL 也可）：

curl -fsSL https://raw.githubusercontent.com/Js2Hou/dsh-mcp-manager/main/scripts/install.sh | bash

Windows（PowerShell 5.1+ / pwsh）：

irm https://raw.githubusercontent.com/Js2Hou/dsh-mcp-manager/main/scripts/install.ps1 | iex

装完硬刷新浏览器（Cmd/Ctrl+Shift+R），打开 设置 → MCP 即可看到管理页。若未出现 MCP 页签，重启一次 DSH（host 半首次挂载需要）。

<b>手动安装 / 本地开发</b>

macOS / Linux（bash）：

cd ~/.dsh/profiles/web

# ① 放行「发布不足 24h」的新版本（装老版本可跳过；若已有该键，把下面那行并入其下即可）
printf '\nminimumReleaseAgeExclude:\n  - @js2hou/dsh-mcp-manager\n' >> pnpm-workspace.yaml

# ② 安装并自动挂载（npm 包；本地 checkout 请用 link: 绝对路径）
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add @js2hou/dsh-mcp-manager

Windows（PowerShell）：

cd ~\.dsh\profiles\web

# ① 放行新版本（一次性；若已有该键，把 - @js2hou/dsh-mcp-manager 并入其下即可）
Add-Content -Path pnpm-workspace.yaml -Value "`nminimumReleaseAgeExclude:`n  - @js2hou/dsh-mcp-manager"

# ② 安装并自动挂载
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add @js2hou/dsh-mcp-manager

dsh plugin --profile web add 会自动：登记依赖 → 识别包内 dsh.bundle.patch → 注册进 dsh.profile.bundles 挂载，无需手改 cordis.patch.yml。

本地开发：clone 仓库后在根目录执行 bash scripts/install.sh（Windows：powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1），脚本检测到 checkout 会自动用 link: 方式安装到 ~/.dsh/profiles/web；也可显式指定：dsh plugin --profile web add "link:C:/绝对路径/dsh-mcp-manager"。

…