kairoz9/dsh-mcp-admin
41Last commit Aug 15, 2026
dsh-mcp-admin DSH plugin
dsh-mcp-admin is a dsh plugin that provides a `/mcp` command to list all MCP servers across profiles with live tool counts, and a Settings panel to manage MCP servers per profile. Changes are written back to `cordis.patch.yml` and automatically hot-reloaded by dsh.
How to install the dsh-mcp-admin DSH plugin
dsh plugin --profile web add ./dsh-mcp-admin-0.2.0.tgzCopying does not run this command. Review the repository and version before installing the dsh-mcp-admin DSH plugin.
dsh-mcp-admin DSH plugin data source
dsh-mcp-admin DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-mcp-admin DSH plugin can do
- List all MCP servers across profiles with real-time tool counts via `/mcp` command
- Add, edit, enable/disable, and delete MCP servers in the Settings panel
- Status dots auto-refresh every second in the Settings panel
- Write changes back to `cordis.patch.yml` with comments preserved, triggering dsh HMR
- Support for never-connected servers (read from full config inventory)
Where the dsh-mcp-admin DSH plugin fits
- Quickly check the status and tool count of all configured MCP servers
- Disable a malfunctioning MCP server without removing its configuration
- Add a new MCP server and have it immediately active via hot-reload
- Edit an existing MCP server's configuration (e.g., endpoint or parameters)
- Delete obsolete MCP servers to keep the configuration clean
Who the dsh-mcp-admin DSH plugin is for
- Developers who use dsh and rely on MCP servers for tool execution
- dsh users who need to manage multiple MCP server configurations from a UI
dsh-mcp-admin DSH plugin limitations
- Only supports the `web` profile (installation commands target `--profile web`)
- Requires dsh environment to be installed and running
- Depends on `cordis.patch.yml` file format; manual edits may conflict
- Focused only on MCP server management; does not provide other MCP protocol features
dsh-mcp-admin DSH plugin: from the repository README
Quoted from the kairoz9/dsh-mcp-admin README, the upstream source of the dsh-mcp-admin DSH plugin. Copyright remains with the original authors.
English | <a href="README.zh.md">简体中文</a> </p> A dsh (DeepSeek Harness) plugin: **Inspect MCP status** (`/mcp` command) + **Manage MCP servers in Settings** (add / edit / delete / enable / disable, written back to `cordis.patch.yml`). [MIT](LICENSE) licensed. `/mcp` command output:  Settings page "MCP" panel:  ## Installation **Release tarball** (Recommended, no build required): Download `dsh-mcp-admin-<version>.tgz` from [Releases](https://github.com/kairoz9/dsh-mcp-admin/releases), then run: ```sh dsh plugin --profile web add ./dsh-mcp-admin-0.2.0.tgz ``` **Build tarball locally** (if building yourself): ```sh pnpm run build # Builds to lib/ pnpm pack # Packages into tarball dsh plugin --profile web add ./dsh-mcp-admin-0.2.0.tgz ``` **Git repository** (installs from source via `prepare` build): ```sh dsh plugin --profile web add github:kairoz9/dsh-mcp-admin ``` > pnpm ≥10 refuses to run the `prepare` script of git dependencies by default, which causes the initial Git installation to fail. dsh will print the fix in the error message: add the package key to that profile's `pnpm-workspace
Read the full READMERepository license: MIT
dsh-mcp-admin DSH plugin questions
How do I install dsh-mcp-admin?
You can install it from a release tarball, a locally built tarball, or via a Git repository. The recommended method is to download the tarball from the Releases page and run `dsh plugin --profile web add ./dsh-mcp-admin-<version>.tgz`. If installing from Git, you may need to add `dsh-mcp-admin` to the `allowBuilds` list in your `pnpm-workspace.yaml` to avoid build failures.
Does the plugin support profiles other than 'web'?
The plugin is designed for the `web` profile. The installation commands explicitly use `--profile web`, and the plugin reads/writes profile-specific `cordis.patch.yml` files. Using it with other profiles has not been tested.
How do I uninstall dsh-mcp-admin?
Run `dsh plugin --profile web remove dsh-mcp-admin`. This will remove the plugin and its associated settings from the profile. If you manually added the `allowBuilds` entry in `pnpm-workspace.yaml`, you can remove it after uninstallation.
Do I need to restart dsh after adding or modifying a MCP server?
No. The plugin writes changes back to `cordis.patch.yml` and dsh's hot-reload mechanism automatically picks up the modifications. MCP servers become active or inactive without a restart.
What if the `/mcp` command shows a server with 0 tools?
A server showing 0 tools may indicate that the connection failed or the server has no tools available. The plugin distinguishes between 'connected', 'instance present with 0 tools (connection failed)', and 'not loaded'. Check the server's endpoint and credentials in the Settings panel.