dsh-mcp-view
DeepSeek Harness Web GUI 的 MCP Tools 面板：查看会话中可用的所有 MCP 服务器和工具，按服务器分组，并显示传输信息、JSON 架构、实时搜索及根据真实会话日志得出的最后使用时间。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-mcp-view@0.2.1
Mcp View 以 dsh-mcp-view 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A floating MCP inventory panel for the DSH sidebar: servers grouped, tools with JSON schemas, live search, and last-used times pulled from real session logs — nothing invented.
DSH runs your MCP servers (docs, build & analytics — whatever you have configured) and registers their tools into the shared mcp__* namespace — but there was no UI to see them. This plugin adds a one-click panel that answers: what MCP servers are configured, which tools are registered, what their input schemas look like, and when each was last used.
| 🖥 All servers, one panel | Every dsh-mcp-client instance in your profile, with transport (stdio / streamable-http) and endpoint (command or URL), plus connection state (active / disabled / no tools). |
| 🗂 Collapsed by default | Servers are folded into a single compact row; one click expands the tool list. + / − in the header expands or collapses everything. |
| 🧬 Full JSON schemas | Each tool shows its raw name, description and the exact inputSchema the model sees — expandable, prettified. |
| 🕘 Last-used times & usage | Derived from real tool/call events in ~/.dsh/sessions/**/session.jsonl[.zstd] — per tool and per server, plus a Usage tab with total calls, a calls-per-day chart and the most-used tools. |
| 🔍 Live search | Filter by tool name, raw name, description, server or parameter names; auto-refresh every 10 s plus a manual refresh button. |
| 🎯 Per-session view | Toggle to see only the tools the current session's agent really sees (resolved from the session's agent scope). |
| ❤️ Favorites & sorting | Star servers/tools; sort by name / tools / last-used / favorites. State persists in localStorage. |
| ⚕️ Health checks | One-click probe of streamable-http endpoints (HEAD) → up/down badge per server. |
| 📤 Export | Download the whole inventory as JSON or Markdown. |
| 🧩 Non-MCP context | A collapsible list of the other (built-in / plugin) globally-registered tools, so you can see the whole tool landscape at a glance. |
The plugin accepts an optional config object on its row in cordis.patch.yml:
- insert:
- id: mcp-view
name: 'dsh-mcp-view'
config:
enabled: true # master switch (default true)
announceToAgent: true # announce the plugin in the model's prompt band (default true)
| Light | Dark | |
|---|---|---|
| Servers | servers light | servers dark |
| Usage | usage light | usage dark |
git clone https://github.com/stopchewing/dsh-mcp-view.git
cd dsh-mcp-view
dsh plugin --profile web add link:$(pwd)
Then restart dsh web and refresh the page — a 「MCP Tools」 button appears at the bottom of the sidebar.
dsh plugin --profile web add dsh-mcp-view
git clone https://github.com/stopchewing/dsh-mcp-view.git
dsh plugin --profile web add link:/absolute/path/to/dsh-mcp-view
Put this package into the profile's node_modules (copy, or a junction on Windows):
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-mcp-view" -Target "<abs-path>\dsh-mcp-view"
Append to ~/.dsh/profiles/web/cordis.patch.yml:
- insert:
- id: mcp-view
name: 'dsh-mcp-view'
Restart dsh web, then F5 the page.
The profile patch is watched, so the host half activates live; the client bundle is served fresh at
/plugins/dsh-mcp-view/client.js— a page refresh is all the browser needs.
Esc or ✕ closes the panel.| Half | File | Role |
|---|---|---|
| Host | lib/index.js | GET /api/mcp-view/tools returns the JSON inventory: MCP instances from the Cordis loader, live tool schemas from ctx.tools, and last-use history scanned from session logs (incremental scan memoized by file mtime/size, 15 s TTL). |
| Browser | lib/client.js | Client plugin bundle: registers the sidebar toggle in the sidebar.footer.action slot and the floating panel in the shell.overlay slot. |
No changes to dsh sources — it is a hot-pluggable profile plugin, same mechanism as the @linxin666 web-ui family.
/api/mcp-view/tools route is served by the same-origin webserver; it is read-only — it cannot call MCP tools, only list them.@deepseek-ai/dsh 0.1.0-rc.6 (web profile) — same cadence as the ecosystem's pinned SDK versions.^22.19.0 || >=24.0.0 (the dsh runtime requirement — zstd session decoding is used).Are MCP servers per-session or shared?
Shared. MCP servers are configured once at the profile level (cordis.patch.yml), connect once per process, and register their tools into the process-wide ToolRuntime — every session and workspace sees the same set. A session whose agent preset restricts tools may hide them from the model, but the registry stays global.
Where does «used …» come from?
From tool/call events in your persisted session logs (~/.dsh/sessions). It is the real dispatch timestamp of the last call of that tool. If the log has no calls for a tool, the hint is simply absent.
Why are only some tools listed under "Other tools"?
The panel shows the global registry. Per-session agent tools (e.g. pwsh, read) register in the session's scope layer, so they are not part of the global view.
Does the panel slow things down? No. The session scan is incremental (only changed files are re-read) and rate-limited to once per 15 s; the browser auto-refresh is 10 s.
dsh-mcp-view/
├─ src/
│ └─ index.ts # host plugin (TypeScript): route + inventory + session scan
├─ lib/
│ ├─ index.js # compiled host output (npm run build)
│ └─ client.js # browser bundle (window.__ModuleLoader__)
├─ test/ # node --test unit tests
├─ cordis.patch.yml # profile roster insert
├─ docs/ # preview data, template, screenshots, architecture
└─ package.json # dsh.bundle.patch + dsh.client manifest
The host plugin is written in TypeScript (src/index.ts); compile it with
npm run build (emits lib/index.js + types). The browser bundle
(lib/client.js) uses the DSH module-loader format and is maintained as a
checked JS bundle. Run npm test (Node's built-in test runner) and
npm run typecheck locally.
Rebuild the README preview screenshots (requires Chrome):
# 1. merge live inventory + session scan into docs/preview.html
# (docs/preview-data.json + docs/preview.template.html → docs/preview.html)
# 2. screenshot with headless Chrome:
chrome --headless=new --screenshot=docs/screenshots/panel-light.png --window-size=1120,760 "file:///abs/path/docs/preview.html?theme=light"
# repeat with ?theme=dark
Found a bug, want a new view (per-session visibility, tool stats, dark-mode polish)? Open an issue or send a PR — they're welcome.
Star ⭐ this repo if the panel made your MCP tooling visible — it helps other DSH users find it (and it keeps the maintainers motivated). After your first release, submit it to awesome-dsh-plugin and awesome-deepseek-harness to reach the whole ecosystem.
MIT © 2026 stopchewing