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 | 中文

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