@fishlikewater/dsh-mcp-manager

使用

设置页各字段：

字段	传输	说明
名称（serverName）	两者	[A-Za-z0-9_-]{1,32}，全局唯一，决定工具名前缀 mcp____…
传输方式	两者	stdio / streamable-http
命令（command）	stdio	可执行文件（支持绝对路径）或 npx 之类命令
参数（args）	stdio	每行一个
环境变量（env）	stdio	每行 KEY=VALUE
工作目录（cwd）	stdio	可选
URL	http	如 http://localhost:3000/mcp
请求头（headers）	http	每行 KEY: VALUE

保存后立即生效；删除后对应工具立即移除。

每张服务器卡片上的「关闭 / 开启」按钮会立即停止 / 启动对应实例：关闭后工具马上移除、不再重连；开启后重新挂载并注册工具。开关状态（enabled，默认 true）随配置一起持久化在 settings.yaml，重启 dsh 后保持；只影响被切换的那一台，其余服务器不受影响。

示例

examples/mcp-servers.example.yaml 给出了 settings.yaml 中 mcp 命名空间的示例（stdio 与 streamable-http 各一）。可以直接把它合并进 $DSH_HOME/settings.yaml 作为初始配置，再从设置页调整。

HTTP 接口（供设置页使用）

方法	路径	说明
GET	/api/mcp/servers	返回 { servers, status }，status 是 serverName -> { state: 'ok'|'error'|'disabled', message }
POST	/api/mcp/servers	请求体 { servers: [...] }，整体替换并触发重挂载；校验失败返回 400 { error }