READMESource: main@f08d0cfc
mcp-visualizer
mcp-visualizer(包名 dsh-mcp-visualizer-ad)是 DeepSeek Harness / dsh 的 MCP 服务器可视化插件:
把当前 profile 里配置的 MCP 服务器列出来,显示服务名、启用状态与详情,并支持一键启用/禁用。
- 对话顶部视图标签:
Chat / Trajectory / Statistics / mcp-visualizer,点mcp-visualizer直接在对话区查看。 - 设置页:
设置 → mcp-visualizer(不打开会话时也能看)。 - 两个入口渲染同一个面板,只读信息 + 启停开关。
功能
- 列表:服务名、行 id、传输方式(stdio / streamable-http)、状态(已连接 / 已启用·暂无工具 / 加载中 / 已禁用 / 加载失败 / 行被锁定)。
- 统计:服务器总数、已启用、已禁用、当前暴露的工具总数。
- 点一行展开详情:
- 状态与 Loader 加载阶段;
- stdio:命令、参数、工作目录、环境变量键名(值绝不回显);
- streamable-http:脱敏端点(只到
协议//主机/…)、请求头键名; - 该服务器当前注册的
mcp__<server>__*工具清单; - 行 id、启动失败即拒绝激活、单次调用超时、重连策略、宿主锁定原因。
- 每行右侧的开关可启用 / 禁用该 MCP 服务器:
- 走官方
pluginManager.setPluginEnabled,写入 profile patch 的disabled覆盖,重启后仍然生效; - 禁用后该行热重载,工具从模型工具表移除;重新启用后工具会回来;
- 面板每 10 秒自动刷新,也可以手动刷新。
- 走官方
- 每 10 秒自动刷新一次,另有手动「刷新」。
安全边界
- 只接受
@deepseek-ai/dsh-mcp-client的行:宿主半侧会校验目标行,传别的插件 id 会被拒绝,不会误切其他插件。 - URL 只返回
协议//主机/…掩码;HTTP 头与 stdio env 只返回键名,不返回取值。 - 启停写回使用 dsh 官方插件管理器通道(与「设置 → 插件」里的启停是同一机制),不手改 profile 文件。
安装
方式一:从 GitHub 安装(推荐)
plugin_manager action: install_bundle target: github:zmq6931/dsh-mcp-visualizer-ad
安装完成后刷新一次 Web GUI(Ctrl+F5),设置里和对话标签行里就会出现 mcp-visualizer。
方式二:本地目录安装
git clone https://github.com/zmq6931/dsh-mcp-visualizer-ad.git C:\path\to\dsh-mcp-visualizer-ad
然后:
plugin_manager action: install_bundle target: C:\path\to\dsh-mcp-visualizer-ad
本插件是 profile 级 bundle:安装后会写入当前 profile 的依赖与
dsh.profile.bundles,只影响该 profile。
使用
- 打开任意会话,对话顶部视图标签行会出现
mcp-visualizer;或打开设置 → mcp-visualizer。 - 列表里每行是一台 MCP 服务器;点一行展开详情。
- 右侧开关切换启用/禁用。切换后面板会立即刷新;若宿主提示「需要重启生效 / 被更高优先级覆盖」,面板会显示对应说明。
- 若某行显示「行被锁定」,说明宿主判定该行不可管理(例如多层重复声明),开关会置灰,需手工修改 profile patch。
写回位置
- 启停由官方
pluginManager.setPluginEnabled写入 profile 的cordis.patch.yml顶层disabled覆盖; - 你原来手写的
insert行(含注释)保持不变; - 「新增 / 修改 / 删除」MCP 行仍然请用 profile patch 或 MCP 客户端管理面板(本插件不提供增删改)。
兼容性
- 在 dsh
0.2.2-rc.1(DeepSeek Harness 0.2)上开发与验证。 - 客户端为纯 JS 的 module-loader 包,无构建步骤、无运行依赖;宿主半侧只用 Cordis 服务(
loader/pluginManager/tools/connection),不 import 任何 Host 包。
目录结构
dsh-mcp-visualizer-ad/
├─ index.js # 宿主半侧:MCP 清单 / 启停 RPC(/api/mcp-visualizer)
├─ client.js # 浏览器半侧:conversation.view + settings.section 面板
├─ cordis.patch.yml # bundle patch:插入 mcp-visualizer 行
├─ package.json # dsh.bundle / dsh.client 声明
├─ icon.svg # 插件图标
├─ locale/
│ ├─ en.json # 显示名与描述(英文)
│ └─ zh.json # 显示名与描述(中文)
└─ test/
├─ smoke.mjs # 宿主 RPC 冒烟:清单字段、密钥不泄露、启停成功/拒绝
└─ client-smoke.mjs # 浏览器半侧冒烟:模块格式、slot 注册、开关与页面渲染
开发
node --check index.js
node --check client.js
node test/smoke.mjs
node test/client-smoke.mjs
修改已安装的本地目录后,刷新 Web GUI 即可看到新的客户端代码;宿主半侧由 dsh 的 HMR 热重载,必要时重启一次 dsh 桌面端。
License
English
mcp-visualizer (package dsh-mcp-visualizer-ad) is a read-mostly MCP server view for DeepSeek Harness:
- A
mcp-visualizertab in the Session view bar (next to Chat / Trajectory / Statistics) and a Settings page. - Lists every configured
@deepseek-ai/dsh-mcp-clientrow with its name, transport, load state and details (masked endpoint, command, args, env KEY names only, and themcp__<server>__*tools it currently exposes). - An enable/disable switch per row, written through the official
pluginManager.setPluginEnabledchannel (persists in the profile patch, no manual file edits).
Install:
plugin_manager action: install_bundle target: github:zmq6931/dsh-mcp-visualizer-ad
Then refresh the Web GUI once. Tested on dsh 0.2.2-rc.1.
No comments yet. Be the first to write one.