dsh-mcp-mgr

English | 中文

A workspace-level MCP manager for DeepSeek Harness: declare MCP servers in each workspace's .dsh/dshmm/mcp.json (Claude/Codex-style mcpServers format), auto-discovered and dynamically registered as dsh plugin instances, with a management UI in the settings page.

Features

• Workspace MCP: auto-discovers mcp.json under every registered workspace, hot-syncs on file changes, and unloads on workspace removal
• Profile MCP display: unified display and management of non-workspace mcp-client registrations (profile patch / bundle / --patch)
• Settings tab: MCP server list — source, status, inspect and remove
• Strict mode: when checked, only the current workspace's (the sidebar-selected session's workspace) MCP servers are enabled; switching workspaces unloads the others. Off by default (all workspaces coexist)
• Workspace MCP servers are registered under dsh's standard mcp__<serverName>__<tool> naming, so multiple servers and sources are naturally isolated

Install, update & uninstall

Install/Update:

npx @deepseek-ai/dsh plugin --profile web add dsh-mcp-mgr@latest dsh-mcp-mgr-ui@latest

Start:

npx @deepseek-ai/dsh web

Uninstall:

npx @deepseek-ai/dsh plugin --profile web remove dsh-mcp-mgr dsh-mcp-mgr-ui

Workspace configuration

The plugin auto-detects .dsh/dshmm/mcp.json at the workspace root, for example:

{
  "mcpServers": {
    "unity-mcp": { "type": "http", "url": "http://localhost:8090/" },
    "filesystem": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/data"] }
  }
}

• A missing type is treated as remote Streamable HTTP; ${VAR} environment expansion is supported
• The stdio server's cwd defaults to the workspace root
• serverName must be globally unique; a later duplicate fails loudly (flagged as a conflict in the UI)
• Set "enabled": false on an entry to disable it without removing it (absent means enabled); the settings tab's toggle writes this field

Development

Build:

# host plugin
tsc -p packages/dsh-mcp-mgr && node gen.mjs

# UI plugin (from the ui package directory)
tsc -p packages/dsh-mcp-mgr-ui && tsdown --config-loader tsx --env.DSH_BUILD_FACE client

# regression
node verify.mjs

Note: after changing src/types.ts (wire fields) you MUST re-run gen.mjs and rebuild the UI bundle — a stale typert client codec silently strips unknown fields (e.g. a lost connected keeps the status wrong forever).

Local (source) install verification and uninstall:

# install
node scripts/install.mjs

# uninstall
node scripts/uninstall.mjs

Design docs live in Doc/requirements.md.