Introduction

The philosophy behind DeepSeek Harness (DSH) is “everything is a plugin.” When using MCP (Model Context Protocol) servers, traditional configuration methods (such as manually editing JSON files) can be cumbersome and difficult to debug. The dsh-mcp-servers-panel plugin introduced in this article aims to solve this problem. It seamlessly integrates MCP server management into DSH’s settings panel, providing a visual interface for creating, viewing, modifying, deleting, and starting/stopping servers.

Plugin Positioning

This is a plugin that provides DSH with a native MCP server management interface. It is maintained by whiteS18, open-sourced under the MIT License, and categorized as a workflow plugin.

Core Features

1. Seamless Settings Panel Integration

After installation, the plugin automatically adds an “MCP Servers” tab to the left menu in DSH settings. The interface follows DSH’s official native UI guidelines and uses pure SVG vector icons.

2. Installed MCP Service List

The panel allows you to clearly view the MCP servers currently configured. The list displays the server name, scope (User / Project), and a status indicator light (online in green, disabled in gray, error in red). The top-right corner provides quick actions for “Refresh,” “Add MCP +,” and “Open MCP Config.” Each server card can be expanded by clicking to view the number of discovered tools and their descriptions, and provides an independent start/stop toggle with deletion confirmation.

3. Creating and Editing MCP Services

Supports toggling between “Form” and “JSON” editing modes:
* Form mode: Intuitively enter the service name, transport protocol, executable command, arguments, environment variables, and endpoint URL.
* JSON mode: Supports direct editing of the complete configuration, with smart compatibility for single configuration objects, mcpServers wrapper objects, and common Cursor / Claude Code formats.
Supports freely switching the “scope”: choosing “User” saves the configuration to ~/.dsh/mcp-servers.json, while choosing “Workspace” saves it to <workspace>/.dsh/mcp.json.

4. Native DSH Conversation Invocation

The plugin automatically manages the lifecycle of MCP processes (stdio pipes or HTTP communication) and completes the MCP protocol handshake (initialize -> notifications/initialized -> tools/list). Discovered tools are automatically registered in ctx.tools, making them directly callable by the model and sessions. If tool names are too long or contain invalid characters, they are truncated according to DSH rules and appended with a hash.

5. Cross-Platform and Windows Compatibility

  • Windows stdio enhancement: On Windows, spawn cannot directly run extensionless scripts or .cmd/.bat files. The plugin automatically detects the executable target via PATHEXT and wraps the execution with cmd.exe /d /s /c, resolving ENOENT errors.
  • Environment PATH smart detection: Automatically sniffs and supplements common global environment paths (such as Node.js, npm, pnpm, scoop, mise, cargo, etc.), preventing service startup failures caused by PATH issues.

6. Diagnostics and Visualization

Expanding a server card allows you to view the underlying startup configuration (transport type, command, working directory, etc.). In case of connection errors, detailed error information is displayed. An 8-second handshake timeout protection is included to avoid child process deadlocks.

Installation and Enablement

  1. Environment check: Ensure that Node.js >= 20.0.0 is installed and that the dependencies @deepseek-ai/cordis (^4.0.0) and @deepseek-ai/dsh-tools (>=0.1.0) are satisfied.
  2. Run the installation:
    dsh plugin --profile <name> add dsh-mcp-servers-panel
  1. Restart the application: DSH composes plugins at process startup. After installation, you must completely exit and reopen DSH (not just refresh the page) for the changes to take effect.

Typical Usage

  1. After launching DSH Desktop, go to “Settings.”
  2. Find the “MCP Servers” panel in the sidebar.
  3. Click “Add MCP +” in the top-right corner to create a new service.
  4. In the editor dialog, choose “Form” or “JSON” mode as needed to enter the configuration and set the “scope.”
  5. After saving, expand the server card in the list to confirm that the tools have been loaded, and invoke these tools through native DSH conversations.

Notes

This plugin runs with the privileges of the current DSH process. It is recommended to review the source code and license before installation. Due to the plugin loading mechanism, any configuration change or addition requires a complete restart of the DSH application to be recognized.

Conclusion

dsh-mcp-servers-panel solves MCP service configuration and invocation issues through graphical management, making it suitable for developers who frequently debug or manage multiple MCP tools. For more details and source code, refer to its GitHub repository.