DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

zmq6931 /

zmq6931/dsh-mcp-visualizer-ad

Verified

mcp-visualizer: MCP server view for DeepSeek Harness - list, inspect and enable/disable configured MCP servers from a Conversation view tab or Settings.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
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。

使用

  1. 打开任意会话,对话顶部视图标签行会出现 mcp-visualizer;或打开 设置 → mcp-visualizer。
  2. 列表里每行是一台 MCP 服务器;点一行展开详情。
  3. 右侧开关切换启用/禁用。切换后面板会立即刷新;若宿主提示「需要重启生效 / 被更高优先级覆盖」,面板会显示对应说明。
  4. 若某行显示「行被锁定」,说明宿主判定该行不可管理(例如多层重复声明),开关会置灰,需手工修改 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

MIT


English

mcp-visualizer (package dsh-mcp-visualizer-ad) is a read-mostly MCP server view for DeepSeek Harness:

  • A mcp-visualizer tab in the Session view bar (next to Chat / Trajectory / Statistics) and a Settings page.
  • Lists every configured @deepseek-ai/dsh-mcp-client row with its name, transport, load state and details (masked endpoint, command, args, env KEY names only, and the mcp__<server>__* tools it currently exposes).
  • An enable/disable switch per row, written through the official pluginManager.setPluginEnabled channel (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.

—/ 5

No ratings yet

Verified DSH bundle

Commit f08d0cfc1dec

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout