lwy521/dsh-remote-mcp-manager

dsh-remote-mcp-manager

DSH Web GUI 插件：在设置面板中管理远程/本地 MCP 服务器。

功能

设置侧边栏一级页面（v0.3.0）
- MCP管理：设置侧边栏新增「MCP管理」一级页面，位于「社区插件」下方
- 单个卡片集成：管理配置列表和编辑/新建表单合并为单个卡片，通过状态切换，无需滚动
- 编辑即切换：点击列表中的「编辑」按钮，卡片就地切换为编辑表单
- 未保存提示：表单有修改时点击「返回」弹出自定义弹窗，可选择「保存」或「不保存」
- 自定义弹窗：与卡片主题风格一致的模态对话框，支持深色/浅色主题

配置管理
- HTTP 远程 MCP：添加远程 Streamable HTTP MCP Server（URL、Token、Path、超时时间）
- 本地进程 MCP：通过 stdio 启动本地 MCP Server（命令、参数、环境变量、工作目录）
- 测试连接：HTTP 远程 MCP 支持实时测试连接（MCP 协议初始化 + tools/list）
- CRUD 管理：添加、编辑、删除已配置的 MCP Server
- 持久化：配置写入 cordis.patch.yml，支持热重载

安装

dsh plugin add dsh-remote-mcp-manager

使用

在 DSH Web GUI 的设置侧边栏找到「MCP管理」页面，可：

管理配置
查看已添加的 MCP Server，点击「编辑」就地切换到编辑表单，测试连接、删除

新建配置（HTTP 远程）
- Server 名称：唯一标识，禁止使用中文
- URL：MCP 服务器地址
- API Key / Token：可选，认证信息
- Path：可选，URL 路径
- 超时：可选，默认 60000ms

新建配置（本地进程）
- Server 名称：唯一标识，禁止使用中文
- 命令：可执行文件路径（如 node.exe、python、npx）
- 参数：每行一个参数
- 环境变量：每行 KEY=VALUE
- 工作目录：可选

传输类型

| 类型 | 协议 | 说明 |
|------|------|------|
| HTTP 远程 | streamable-http | 连接远程 MCP 服务器 |
| 本地进程 | stdio | 本地启动子进程 MCP |

变更记录

v0.3.1
- 修复：更新后 token 丢失 — 前后端 token 字段序列化一致，不再丢失 API Key
- 修复：测试连接阻塞 — HTTP 请求添加 15 秒超时（AbortController），避免测试卡死
- 修复：保存按钮失效 — 增加保存回调、首次加载防误存、错误提示展示
- 修复：表单校验增强 — 增加 serverName 格式校验、重名检测、中文名称禁止
- 修复：stdio 属性丢失 — toolCallTimeoutMs 和 failOnStartupError 正确读写透传
- 修复：patch 文件损坏恢复 — 只含 begin 无 end 标记时自动修复，不再静默失败
- 安全增强 — CSRF 同源校验、请求体大小上限 2MB、错误不重复写头
- 体验优化 — 保存失败/表单错误提示展示、忽略空加载数据、路径拼接修复

v0.3.0
- 设置侧边栏一级页面：从「插件」设置页内卡片提升为独立设置页面
- 合并卡片：管理配置列表和编辑/新建表单合并为单个卡片，mode 状态切换
- 编辑即切换：点击列表中「编辑」按钮，卡片就地切换为编辑表单
- 未保存提示：自定义模态弹窗，表单有修改时提示保存/不保存
- 侧边栏标签：改为「MCP管理」

v0.2.0
- 添加 stdio 传输支持（本地进程 MCP）
- 自定义下拉组件替代原生 select
- 超时时间配置
- 会话 ID 透传支持（MCP-Session-Id）