MCP 连接管理器 ComeCaramelos/dsh-mcp-manager

@comecaramelos/dsh-mcp-manager

MCP 连接管理器，用于 DeepSeek Harness。在 Web GUI 里声明多个 MCP 服务器——stdio 和 Streamable HTTP，外加 Chrome 和 Docker Desktop 的 MCP Toolkit——逐个开启或关闭，不用重启配置档。

需要 dsh ^0.2.0（0.2.0 和 0.2.1），运行在 Linux、WSL 或 Windows。

安装

dsh plugin --profile web add @comecaramelos/dsh-mcp-manager-bundle

插件面板里会出现一个条目 MCP connections，包含三个组件：

- MCP connections — 管理器；它的页面就是连接卡片。
- Chrome MCP — 添加 chrome 类型（WSL 下还有 chrome-windows）。
- Docker MCP Toolkit — 添加 docker-profile 类型。

关掉 Chrome 或 Docker，它的类型就从选择器里消失；已保存的连接会保留，并显示一行 "kind … is not registered"，直到你重新开启。

你之前用的是 chrome 1.x 或 docker 0.0.x 的独立 bundle？ 先卸掉：它们和这个 bundle 冲突，而且 chrome 1.x 在 dsh 0.2 里根本加载不了。你的配置不会丢——卡片会提示你创建等效连接。步骤见 docs/knowledge/migracion.md。

使用卡片

插件 → MCP connections → MCP connections。每个连接一行：

| 列 | 显示什么 |
| toggle | 开启或关闭该连接 |
| label · id | 名称；工具显示为 mcp__<id>__<tool> |
| kind | 连接类型 |
| 圆点 + 文字 | 状态：connected、connecting…、failed: …、stopped |
| 数字 | 发布多少个工具 |

Add connection 打开编辑器。编辑连接时如果不改动实际执行的内容，就不会重启它。

- stdio — command、args（每行一个，不加 shell 引号）、env 和 cwd。服务器的 stderr 输出到 dsh 控制台（Console）或单独的文件（Log file，适合吵闹的服务器）；日志路径显示在连接下方。
- HTTP — 基于 Streamable HTTP 的 url 和 headers。
- chrome / chrome-windows / docker-profile — 由组件添加；见 @comecaramelos/dsh-chrome-mcp 和 @comecaramelos/dsh-docker-desktop-mcp 的 README。

示例：Unity 的 MCP relay 是 Windows 可执行文件，在 WSL 里用 dsh 启动：

- id: unity
kind: stdio
enabled: true
command: /mnt/c/<usuario>/.unity/relay/relay_win.exe
args:
- --mcp
stderrMode: log

WSL 和 Windows

两边用法一样；区别在平台：

- chrome-windows（从 WSL 操作 Windows 的 Chrome）只在 WSL 下存在；原生 Windows 用 chrome。
- WSL 里的 Docker 用 Docker Desktop 的 docker.exe（如果存在，路径是 /Docker/host/bin/docker.exe）。Toolkit 需要在 Docker Desktop 里启用 MCP 配置档。
- Windows 的 .cmd（比如 npx）启动时不经过 shell。

添加自己的连接类型

其他包可以用 registerMcpKind 注册一个 kind（或者通过 service mcpConnections）和它们的连接都显示在同一张卡片上。指南见： docs/knowledge/kinds.md。

开发

npm ci
npm run build
npm test
node scripts/link-profile.mjs # enlaza este checkout (y chrome/docker si están al lado) al perfil plugin-dev

要在测试中启动 dsh，请用 scripts/gui.mjs，它不会留下孤儿进程。
细节见 docs/knowledge/desarrollo.md；设计上的取舍见 docs/knowledge/diseno.md。如果你是智能体，请读 AGENTS.md。