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, command or url, enable switch, status) with add / edit / enable / disable / delete / reconnect.
• 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).

License

MIT