跳到正文

ArvinQi/dsh-mcp

31最近提交 2026年8月16日

dsh-mcp DSH 插件

dsh-mcp 为 DeepSeek Harness 提供了可视化的 MCP 服务器管理界面，包括添加、编辑、测试、启停等操作。同时引入基于搜索的注入模式，减少 token 消耗，并保持工具列表稳定，避免缓存失效。

developer-toolsui-productivity

如何安装 dsh-mcp DSH 插件

dsh plugin --profile web add dsh-mcp

复制不会执行命令。安装 dsh-mcp DSH 插件前请核对仓库和版本。

dsh-mcp DSH 插件数据来源

dsh-mcp DSH 插件快照日期：2026年8月16日

discovered

dsh-mcp DSH 插件能做什么

  • 可视化 MCP 服务器管理：通过设置 → MCP 进行添加、编辑、删除、启停、测试连接和刷新。
  • 工具级精细控制：展开每个服务器查看所有工具，取消勾选即可即时禁用注入。
  • 双注入模式：'search'（按需检索，节省 token）和 'full'（全量注入）。
  • OAuth 支持：自动打开浏览器进行授权码 + PKCE 流程，token 持久化并自动刷新。
  • 零 npm 依赖：直接使用 DSH 内部能力，安装即用。
  • 工具列表稳定化：当工具未变化时，避免反复注册/注销导致的缓存失效。

dsh-mcp DSH 插件适合哪些场景

  • 通过单一界面管理多个 MCP 服务器，无需手动编辑配置文件。
  • 使用 search 模式按需注入工具，大幅减少 token 消耗。
  • 安全连接受 OAuth 保护的 MCP 服务器，自动完成浏览器授权。
  • 快速测试 MCP 服务器连通性和工具可用性。
  • 通过选择性启用/禁用特定工具，开发和调试 MCP 工具。

dsh-mcp DSH 插件适合谁

  • 希望使用可视化 MCP 管理界面的 DSH 用户。
  • 使用多个 MCP 服务器并希望优化 token 用量的开发者。
  • 需要在 DSH 中配置 OAuth 认证 MCP 服务器的用户。

dsh-mcp DSH 插件的限制

  • 仅支持 DSH web 环境（profile web）。
  • 需要预先安装 DSH 并在 cordis.patch.yml 中配置条目。
  • OAuth 首次授权需要浏览器交互，连接超时延长至 5 分钟。
  • 本地 link 安装需要额外的 node_modules symlink 设置。
  • host 半部改动需直接编辑构建产物；浏览器半部修改后需重新构建。

dsh-mcp DSH 插件的仓库 README 摘录

以下文字摘自 dsh-mcp DSH 插件的上游仓库 ArvinQi/dsh-mcp 的 README，版权归原作者，仅作引用。

**[English](README.en.md) | 简体中文** [![dshfind](https://dshfind.com/api/badge/ArvinQi/dsh-mcp?lang=zh)](https://dshfind.com/zh/plugins/ArvinQi/dsh-mcp?ref=badge) ![设置页预览](static/snapshot.webp) ## 为什么用 dsh-mcp？ **解决的核心问题：** - **MCP 工具全量注入烧 token**：接入多个 MCP 服务器后工具可达上百个，每轮全量注入开销巨大。`search` 按需检索模式让模型通过 `mcp_tool_search` 热注入所需工具，大幅节省 token。 - **工具列表反复更新破坏缓存**：`tools/list_changed` 通知会让同名工具被反复注销/重注册，系统提示词工具列表抖动、prompt cache 频繁失效。工具列表稳定化让未变化的工具保留原注册，最大化 cache 命中。 - **没有可视化管理入口**：服务器配置、启停、工具勾选全靠手工改文件。Settings → MCP 一站式可视化完成。 **功能优势：** - **可视化管理**：服务器列表 / 新建 / 编辑 / 删除 / 测试连接 / 启停 / 刷新，全 UI 操作 - **工具级精细控制**：每个服务器展开工具列表，默认全选，可取消勾选只加载需要的部分 - **双注入模式**：`search`（按需检索，省 token）与 `full`（全量注入） - **零 npm 依赖**：直接对接 DeepSeek Harness 内部能力，安装即用 - **OAuth 认证支持**：`streamable-http` 服务器若走 MCP OAuth（授权码 + PKCE），连接时自动打开浏览器授权；token 持久化、由 SDK 自动刷新（24 小时内活跃自动续期） - **三种安装方式**：npm / GitHub git 源 / 本地 link；中英文界面与文档 ## 功能 - **托管 MCP 服务器注册表**（host）：持久化定义（storage-domain `mcp_servers`）、按服务器挂载 `@deepseek-ai/dsh-mcp-client` 实例、环境变量注入（明文入定义、secret 走 credentials）、 连接探测（test）。 - **Web 设置管理页**（client）：Settings → MCP，列表/编辑/删除/测试服务器。 - **OAuth 认证**（host，`lib/oauth.js`）：`streamable-http` 服务器遇 401 + OAuth 挑战时自动走 授权码

阅读完整 README仓库许可: MIT

dsh-mcp DSH 插件常见问题

如何安装 dsh-mcp？

可以通过 npm 安装：`dsh plugin --profile web add dsh-mcp`，或从 GitHub 安装：`dsh plugin --profile web add github:ArvinQi/dsh-mcp`。本地开发可以使用 `dsh plugin --profile web add link:<绝对路径>`。安装后，在 `$DSH_HOME/profiles/web/cordis.patch.yml` 中添加插件条目，然后重启 `dsh web` 即可生效。

如何配置受 OAuth 保护的 MCP 服务器？

添加服务器时，如果传输方式为 `streamable-http` 且服务器返回 401 + OAuth 挑战，dsh-mcp 会自动打开浏览器进行授权码 + PKCE 流程。登录并同意后，token 会被持久化，后续连接直接复用。首次授权可能需要等待 5 分钟，但非 OAuth 服务器不受影响。

“search”和“full”注入模式有什么区别？

“search”模式下，模型只在需要时调用 `mcp_tool_search` 检索并热注入特定工具，节省 token 并减少上下文膨胀。“full”模式则一次性将所有启用的工具注入系统提示词，更简单但消耗更多 token。你可以在 MCP 设置页面顶部切换模式。

我可以禁用某个服务器的部分工具而不删除整个服务器吗？

可以。在 MCP 设置页面展开服务器的工具列表，取消勾选不需要的工具，更改即时生效，无需保存。禁用的工具不会注入到系统提示词中，帮助你节省 token。

为什么重启服务器后工具列表会变化？

dsh-mcp 会稳定工具列表：如果工具内容没有变化，它会避免反复注销和重新注册同名工具，从而防止缓存失效。如果你看到意外变化，请确保服务器返回的工具定义一致。你也可以使用 MCP 设置页面上的“刷新”按钮同步最新状态。