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
• 工作目录：可选

传输类型

变更记录

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）