dsh-mcp-manager

Usage

Open Settings → MCP Server Manager:

• Server cards show the name, transport, status badge and endpoint; disabled cards are dimmed.
• Enable/disable switch — disabling disconnects immediately and unloads the server's tools.
• Reconnect — waits for the connection result and refreshes automatically (configurable wait, default 15 s).
• Edit — change transport / URL / command / headers (serverName is immutable); saving hot-reconfigures the live connection.
• Delete — lives at the top of the edit page, behind a two-step confirm (3 s window).
• Add — streamable-http (URL + optional headers) or stdio (command + args), with a configurable connection-wait timeout.

Statuses

Status	Meaning
Connected (n tools)	tools are registered
Connecting	handshake / reconnecting in progress
Offline	was connected, but the server process is unreachable (probed)
Error	initial connect failed (reason shown) or 30 s connect timeout
Disabled	switched off — not connected, no tools

Configuration file

$DSH_HOME/mcp-servers.json — shared by every profile and session:

{
  "version": 1,
  "servers": [
    { "serverName": "my-server", "transport": "streamable-http", "url": "http://127.0.0.1:8080/mcp", "enabled": true }
  ]
}

The file is watched live: manual edits (add / remove / change / enable) take effect within ~1 s; POST /mcp-manager/api/reload triggers it on demand.

HTTP API

Method	Path	Purpose
GET	/mcp-manager/api/health	liveness + version + store path
GET	/mcp-manager/api/servers	list with live (probed) status
GET	/mcp-manager/api/servers/	single server
POST	/mcp-manager/api/servers	add & connect
POST	/mcp-manager/api/servers//update	update config & hot-reconnect (serverName immutable)
POST	/mcp-manager/api/servers//toggle	enable / disable (`{"enabled": true
POST	/mcp-manager/api/servers//reconnect	disconnect & reconnect
DELETE	/mcp-manager/api/servers/	disconnect & delete
POST	/mcp-manager/api/reload	re-read the config file from disk

Configuration file

$DSH_HOME/mcp-servers.json — shared by every profile and session:

{
  "version": 1,
  "servers": [
    { "serverName": "my-server", "transport": "streamable-http", "url": "http://127.0.0.1:8080/mcp", "enabled": true }
  ]
}

The file is watched live: manual edits (add / remove / change / enable) take effect within ~1 s; POST /mcp-manager/api/reload triggers it on demand.