dsh-mcp-ui
MCP 服务器可视化配置插件:在 DSH Web 设置界面管理 Model Context Protocol 服务器,自动装配官方 dsh-mcp-client 插件实例,保存即生效,无需手改配置文件。
功能
- 🖥️ 图形化设置卡片:设置在 设置 > 插件 > 插件配置 > MCP 服务器,与 vision-router 等插件的卡片同款风格
- 🔌 两种传输都支持:stdio(本地进程)、streamable-http(远程 URL)
- 📝 完整字段:serverName、command/args/env/cwd、url/headers、工具调用超时、启动失败策略、自动重连(开关/延迟/上限/次数)
- 🔄 热同步:保存后 host 端自动挂载/卸载对应的
dsh-mcp-client实例,无需重启 dsh - 🛡️ 安全:服务器列表存于
~/.dsh/settings.yaml,env 里的密钥可填环境变量引用
安装
# GitHub 方式
dsh plugin --profile web add github:quan-v/dsh-mcp-ui> 后续发布到 npm 后,dsh plugin --profile web add dsh-mcp-ui 同样可用。
重启 web 后,在 设置 > 插件 > 插件配置 找到「MCP 服务器」卡片。
使用
1. 打开设置卡片,点击「+ 添加服务器」 2. 填好 serverName(唯一命名空间,模型侧工具名为 mcp__<serverName>__<工具名>) 3. 选择传输方式(stdio / streamable-http / SSE)并填写对应字段 4. 点击保存 —— host 端自动连接,模型即可调用该服务器的工具
配置存储
服务器列表存在 settings.yaml 的 mcp-ui: 段,与其它插件设置同级:
mcp-ui:
servers:
- serverName: github
transport: stdio
command: npx
args:
- -y
- '@modelcontextprotocol/server-github'
env:
GITHUB_TOKEN: ${GITHUB_TOKEN}
toolCallTimeoutMs: 60000
failOnStartupError: false
reconnect:
enabled: true
initialDelayMs: 500
maxDelayMs: 30000
maxAttempts: 10与 dsh-mcp-client 的关系
本插件不实现 MCP 协议,只负责两件事:
1. 提供设置卡片,把用户配置存进 settings.yaml 2. host 端监听配置变化,动态调用 ctx.plugin() 挂载/卸载 @deepseek-ai/dsh-mcp-client 实例
官方 dsh-mcp-client 负责真正的连接、工具发现和 mcp__server__tool 命名注册。
更新日志
1.0.1 (2026-08-22)
- 修复:
settings.plugin.item插槽注册补上显式key字段。DSH 0.1.1+ 要求 keyed slot 必须声明options.key,否则插件加载失败(报keyed slot "settings.plugin.item" requires options.key)。
License
MIT