dsh-mcp-list

Readme

# dsh-mcp-list

A [DeepSeek Harness](https://www.npmjs.com/package/@deepseek-ai/dsh) web plugin
that adds an **MCP** page to the Settings panel:

- Lists every mounted MCP server and its tools, grouped by server name.
- Truncated tool descriptions expand to the full text on click.
- A call-count column plus a per-server total-calls badge, computed by scanning
  the most recent sessions for `mcp__<server>__<tool>` occurrences
  (index-free, works with `session-query openAt: "never"`).
- `Open config` opens the deployment's `cordis.patch.yml` MCP patch file in
  the system editor (`open` / `xdg-open`).

## Layout

- `lib/index.js` — Host half. Injects `webServer` and serves same-origin JSON
  routes under `/mcp-list` (`/servers`, `/counts`, `/open-config`).
- `lib/client.js` — Web Client half (`dsh.client`, platform `web`). Registers
  the settings page through the `settings.section` slot and fetches the routes
  above.

## Install / Uninstall

Self-mounting bundle (`dsh.bundle` → `cordis.patch.yml`): `dsh plugin add`
reconciles the profile's `dsh.profile.bundles` automatically — **no manual
insert entry in the profile's own `cordis.patch.yml`**, and `dsh plugin remove`
uninstalls cleanly without leaving a dangling loader entry.

```bash
dsh plugin --profile web add https://github.com/dmz2922990/dsh-mcp-list.git
dsh plugin --profile web remove dsh-mcp-list
```

Without the `dsh plugin` CLI, install the package into the profile directory
(`npm install git+https://github.com/dmz2922990/dsh-mcp-list.git`) and add the
one insert entry from this package's `cordis.patch.yml` to the profile's
`cordis.patch.yml`; on uninstall, remove the package **and** that entry
together, or the next `dsh` start fails with `ERR_MODULE_NOT_FOUND`.

## License

MIT