# 🔌 dsh-mcp-view
### 在 DeepSeek Harness Web GUI 中，一眼看清会话里所有的 MCP 服务器与工具。
**中文** · [English](README.md) · [Русский](README.ru.md)
[](LICENSE)
[](https://www.npmjs.com/package/dsh-mcp-view)
[](#)
[](#)
[](#)
[](#contributing)
[](https://github.com/beancookie/awesome-dsh-plugin)
*一个悬浮的 MCP 清单面板：服务器分组展示、工具 JSON Schema、实时搜索，以及**从真实会话日志中提取的最近使用时间**——绝不凭空捏造。*
---
DSH 会运行你的 MCP 服务器（文档、构建、分析——任意你配置的服务器），并把它们的工具注册进共享的 `mcp__*` 命名空间——但**一直没有一个 UI 可以查看它们**。这个插件提供一个一键面板，回答三个问题：*配了哪些 MCP 服务器、注册了哪些工具、每个工具的参数模式长什么样、各自最后一次被调用是什么时候。*
## ✨ 功能特性
| | |
|---|---|
| 🖥 **一个面板看全部服务器** | 配置里的每个 `dsh-mcp-client` 实例，含传输方式（`stdio` / `streamable-http`）与端点（命令或 URL），以及连接状态（运行中 / 已禁用 / 无工具）。 |
| 🗂 **默认折叠** | 服务器折叠成一行紧凑条目，点击即可展开工具列表；面板头部的 `+` / `−` 一键全部展开或收起。 |
| 🧬 **完整 JSON Schema** | 每个工具展示原始名称、描述和模型实际看到的 `inputSchema`，可展开、美化显示。 |
| 🕘 **最近使用时间与用量** | 从 `~/.dsh/sessions/**/session.jsonl[.zstd]` 中的真实 `tool/call` 事件提取——工具级与服务器级都有，另有用量页：总调用数、每日调用图、最常用工具。 |
| 🔍 **实时搜索** | 按工具名、原始名、描述、服务器**或参数名**过滤；每 10 秒自动刷新，另有手动刷新按钮。 |
| 🎯 **按会话视图** | 可切换到只显示当前会话 agent 真正可见的工具（按会话的 agent scope 解析）。 |
| ❤️ **收藏与排序** | 收藏服务器/工具；按名称/工具数/最近使用/收藏排序；状态保存在 `localStorage`。 |
| ⚕️ **健康检查** | 一键探测 streamable-http 端点（HEAD）→ 每个服务器的 up/down 徽标。 |
| 📤 **导出** | 将完整清单下载为 JSON 或 Markdown。 |
| 🧩 **非 MCP 工具上下文** | 可折叠展示其它（内置 / 插件）全局注册的工具，一眼看清完整的工具版图。 |
## 📸 截图
| | 浅色 | 深色 |
|---|---|---|
| **Servers** |  |  |
| **Usage** |  |  |
## ⚡ 快速开始
```sh
git clone https://github.com/stopchewing/dsh-mcp-view.git
cd dsh-mcp-view
dsh plugin --profile web add link:$(pwd)
```
然后**重启 `dsh web`** 并刷新页面——侧边栏底部会出现 **「MCP Tools」** 按钮。
## 📦 安装
### 从 npm
```sh
dsh plugin --profile web add dsh-mcp-view
```
### 从仓库
```sh
git clone https://github.com/stopchewing/dsh-mcp-view.git
dsh plugin --profile web add link:/absolute/path/to/dsh-mcp-view
```
### 手动安装（不使用 CLI）
1. 把本包放进 profile 的 `node_modules`（复制，或在 Windows 上创建 junction）：
```powershell
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-mcp-view" -Target "