dsh-easy-mcp
Visual MCP server manager for DeepSeek Harness: view, add, edit, enable/disable, delete, reconnect, and test MCP servers from a dedicated MCP Servers page — tools register/unregister live with config changes, no restart, no hand-written YAML.
English | 中文
MCP Servers page
Features
- MCP Servers page in Settings: server list (name, transport stdio / streamable-http / SSE, command or url, enable switch, status) with add / edit / enable / disable / delete / reconnect.
- Full protocol coverage: tools plus resources (registered as
read_resource tools), prompts (registered as use_prompt tools), logging (server logs forwarded to host log), roots (announced empty), and sampling (explicitly rejected with a clear error).
- Image content bridge: image blocks returned by servers are saved to a temp file and the model is pointed to
read_image — no more content discarded.
- SSE transport (legacy pre-2025-03 protocol) in addition to stdio and streamable-http.
- Argument validation: tool arguments are validated locally against the server's input schema before the network round-trip; clear errors instead of server-side surprises.
- Connect test: probes each server via
initialize + tools/list, reports latency and tool count; failures show the concrete error.
- Error visualization: anomalies show the concrete error (ENOENT, ECONNREFUSED, timeout, …) in red under the card.
- Auto backup: every UI save backs up the config to
~/.dsh/dsh-easy-mcp/backups/ (keep latest 5), so misconfigurations are always reversible.
- Live updates: config is stored in the
mcp section of ~/.dsh/settings.yaml and hot-synced — no structural-layer edits, no restart needed.
- Self-contained engine: built on
@modelcontextprotocol/sdk, no dependency on the official dsh-mcp-client package.
- Bilingual UI (中文 / English).
Installation
dsh plugin --profile web add dsh-easy-mcp # install
dsh plugin --profile web remove dsh-easy-mcp # uninstall
Restart dsh web, then open Settings → MCP Servers.
Configuration
Servers are stored in the mcp section of ~/.dsh/settings.yaml and managed in the UI (manual edits are hot-synced too):
mcp:
servers:
- name: playwright
enabled: true
transport: stdio
command: /opt/homebrew/bin/node
args:
- /path/to/playwright/mcp/cli.js
The plugin ships an empty default — no server is preconfigured. Missing fields are filled with schema defaults (enabled: true, env: {}, reconnect on, …).
Notes
command may be a PATH short name (playwright-mcp, node, npx) only when the dsh process can find it. If dsh web is launched from Finder / launchd / a shell without fnm, use absolute paths (command: /opt/homebrew/bin/node + absolute args).- Resources/prompts are registered as tools with a per-server cap of 50 combined (excess entries are skipped with a log line).
- SSE is the pre-2025-03 protocol — prefer streamable-http for new servers; SSE is kept for legacy servers.
- Image temp files live under the system temp dir (
dsh-easy-mcp-images/) and are cleaned up on disconnect.
License
MIT
