dsh-mcp-manager
English | 中文
MCP connection lifecycle management plugin for DeepSeek Harness.
Manage MCP server connections from the DSH Web GUI Settings → Plugins page, and from chat via mcp_list_connections / mcp_add_connection / mcp_remove_connection / mcp_test_connection tools. All changes persist to ~/.dsh/mcp-connections.json and survive restarts.
Features
| Feature | UI (Settings → Plugins) | Chat (tools) |
|---|
| List connections | ✅ | mcp_list_connections |
| Add connection (HTTP/stdio) | ✅ | mcp_add_connection |
| Remove connection | ✅ | mcp_remove_connection |
| Test connection + show tools | ✅ | mcp_test_connection |
| Persist across restarts | ✅ (auto) | ✅ (auto) |
| Stdio auto-download + progress bar | ✅ | — |
Architecture
┌──────────────┐ GET/POST ┌─────────────────────────┐
│ Browser UI │ ─────────────────→│ /mcp-manager/connections│
│ (client.js) │ ←── JSON array ── │ (index.js handler) │
└──────────────┘ └───────────┬─────────────┘
│ read/write
┌──────────▼──────────────┐
│ ~/.dsh/mcp-connections.json
└──────────┬──────────────┘
│ startup restore
┌──────────▼──────────────┐
│ ctx.loader.create() │
│ @deepseek-ai/dsh-mcp-client
└──────────────────────────┘
All reads and writes go through a single JSON file. The UI calls the HTTP endpoint; server tools write the same file. At startup, connections are restored automatically.
Installation
Option 1: dsh plugin add (recommended)
dsh plugin --profile web add github:haode01/dsh-mcp-manager
Installs into ~/.dsh/profiles/web/, auto-adds to cordis.yml as a profile bundle layer. No manual symlink or --patch needed.
Restart DSH:
dsh web
Option 2: Git clone + symlink
git clone https://github.com/haode01/dsh-mcp-manager.git /path/to/dsh-mcp-manager
ln -s /path/to/dsh-mcp-manager ~/.dsh/profiles/web/node_modules/dsh-mcp-manager
dsh web --patch /path/to/dsh-mcp-manager/cordis.patch.yml
Option 3: Cordis config
- insert:
- id: mcp-manager
name: 'dsh-mcp-manager'
Verify
Open Settings → Plugins — an MCP Manager card should appear. In chat, mcp_list_connections should respond.
Usage
Add from UI
- Settings → Plugins → MCP Manager → expand card
- Choose HTTP or Stdio tab
- HTTP: server name + URL (optional Bearer token)
- Stdio: server name + full command (e.g.
npx -y @mozilla/firefox-devtools-mcp@latest)
- Click Add → auto-save → auto-test → tool list with progress bar
Add from chat
Add MCP connection http://10.118.81.110:3100/mcp/openwrt with name "openwrt"
AI calls mcp_add_connection — connection is immediately available and persisted.
Test connections
Every connection has a Test button. HTTP tests in-browser; Stdio tests via server endpoint with download progress.
File structure
dsh-mcp-manager/
├── index.js # Server plugin: tools + HTTP endpoints + startup restore
├── lib/
│ ├── client.js # Browser plugin: Settings UI card
│ ├── mcp-manager.js # Runtime connection create/list/remove via ctx.loader
│ └── test-connection.js # One-shot connection test
├── cordis.patch.yml # Cordis loader patch
└── package.json
License
MIT
