Preface¶
When maintaining MCP servers in DSH (DeepSeek Harness), common issues aren’t just about “whether it’s connected,” but also whether the tool count is normal and whether the status across different profiles is consistent. Looking only at a single profile or manually browsing configurations can easily cause you to miss disconnected servers.
dsh-mcp-admin is a DSH plugin used to view MCP status and manage MCP servers per profile in the settings page.
What Is This¶
dsh-mcp-admin is maintained by kairoz9 and is licensed under MIT.
It provides two entry points:
- The /mcp command: Lists MCP servers and real-time tool counts.
- The MCP panel in the settings page: Manages MCP servers per profile.
Saving operations write back to the profile’s cordis.patch.yml and then trigger dsh’s hot module reload (HMR).
Core Features¶
/mcp Command¶
After running /mcp, you can list MCP servers across all profiles and see real-time tool counts. The list includes servers that have never connected.
MCP Panel in the Settings Page¶
The MCP panel in the settings page supports managing MCP servers per profile:
- Add
- Edit
- Disable
- Enable
- Delete
Status dots refresh automatically every second. After saving, the configuration is written back to the profile’s cordis.patch.yml, and dsh automatically performs HMR.
Installation and Enabling¶
The following command installs the plugin into the web profile:
dsh plugin --profile web add github:kairoz9/dsh-mcp-admin
The README recommends pinning to a commit or tag, for example:
dsh plugin --profile web add github:kairoz9/dsh-mcp-admin#v0.2.0
If installation from Git fails with pnpm >=10, note that pnpm >=10 refuses to run Git dependencies’ prepare scripts by default, which may cause the first Git installation to fail. You can add the following to the profile’s pnpm-workspace.yaml:
allowBuilds:
dsh-mcp-admin: true
Then rerun the add command.
Typical Usage¶
- View MCP status
Run:
/mcp
The command lists MCP servers across all profiles and displays real-time tool counts. Servers that have never connected also appear in the list.
- Manage MCP servers for a specific profile
Go to the MCP panel in the settings page, select the target profile, and then add, edit, disable, enable, or delete.
- Save and apply
Saving writes back to the profile’s cordis.patch.yml. dsh then automatically performs HMR.
Use Cases and Notes¶
Suitable for users who maintain MCP servers across multiple DSH profiles and want to directly view status and adjust configurations.
Notes:
- The plugin runs with the current dsh process permissions. Review the source code and MIT license before installation.
- Saving writes back to cordis.patch.yml, which is a profile configuration change.
- Under pnpm >=10, installation from Git may fail; you need to add allowBuilds and retry.
Conclusion¶
dsh-mcp-admin combines /mcp status viewing with MCP management in the settings page, making it ideal for developers who frequently adjust MCP server configurations and want to complete viewing and saving directly within DSH.
Project address:
https://github.com/kairoz9/dsh-mcp-admin