前言¶

在 DeepSeek Harness（DSH）里接 MCP，常见做法是改配置文件或手写 mcpServers JSON：远程 URL、stdio 命令、请求头密钥混在一起，改一处就要重启或重载；MCP 服务器一旦挂上，往往整包工具都会进模型的 tool schema，用不到的定义照样占上下文，还容易误触发。社区插件 dsh-mcp-tools（维护者 hxlog）把这件事收进 设置 → MCP：添加服务器、测连通性、像 Postman 一样填请求头，并按工具粒度启用或停用。下面介绍它是什么、能做什么，以及如何安装与上手。

这是什么¶

dsh-mcp-tools 是发布在 npm 上的 DSH 插件（当前包版本 1.0.2，MIT 许可证），定位是「简洁、优雅的 MCP 工具管理器」。README 将其描述为类 Cursor 风格的全局 MCP 控制：自由添加、停用、删除 MCP 接口与工具，适合 MCP 测试、按需请求、拓展上下文等场景。

插件分 Host 与客户端：Host 通过 cordis bundle patch 复用 DSH 原生 MCP 客户端；客户端在设置里增加分区「MCP」（id: mcp，order: 18），使用 classic script，无需构建。状态保存在本机 ~/.dsh/dsh-mcp-tools/state.json，原子写入，并监听外部修改以热应用。

目录页：SkillHub 插件页。源码与文档：GitHub hxlog/dsh-mcp-tools。

核心功能¶

服务器管理¶

支持两种传输方式：

1. streamable-http：填写 URL 与请求头（键值对行，非整段 JSON 文本框）。
2. stdio：填写命令、参数、环境变量、工作目录。

也可以直接粘贴 {"mcpServers": { ... }} 一次导入多个服务器。关闭某台服务器的开关会断开连接并注销其全部工具，但不删除配置；支持一键复制该服务器的 mcpServers 片段。

请求头与密钥¶

远程 MCP 的密钥按 Postman 式键值对填写：默认带一行 x-mcp-key；值默认掩码、可逐行显示；名称重复会在界面就地报错。README 安全说明指出：请求头以明文保存在本地状态文件，仅在本机，不要提交到仓库或同步到公开位置；建议每个 MCP 服务器使用独立、最小权限的密钥。

逐工具控制¶

每个 MCP 工具在界面上是一个 chip。点击停用后，该工具不会注册进模型——既不占上下文，也无法被误调用；这与「注册了再在调用时报错」不同，停用在注册阶段生效。列表支持搜索、全选、反选、全部停用；悬停可查看完整工具描述。

连通性测试与事件日志¶

「测试连接」会临时建连：initialize → tools/list → 关闭，回报耗时、协议版本、工具数量，不影响当前运行中的服务器。界面「最近事件」记录连接、重载、测试与失败。

与 DSH 原生体验一致¶

界面沿用 DSH 的 --dsw-* 设计 token、平铺行与 32px 输入框，深浅色与中英文自适应。除你配置的 MCP 服务器外，插件不发起额外网络请求，README 写明无遥测。

安装与启用¶

环境要求：

• DeepSeek Harness 0.2.x（dsh web 或 DSH Desktop）
• Node.js ≥ 22.13

注意：这是 DSH 插件，不是普通应用依赖；npm i dsh-mcp-tools 只会下载包，运行时仍需装进 DSH profile。升级包版本后需要重启 dsh web 或 DSH Desktop。

通过插件页安装（README 推荐）

1. 打开 DSH Web（或 DSH Desktop）→ 侧边栏 插件（Desktop 在 设置 → 插件）。
2. 点击安装，填入 dsh-mcp-tools，确认。
3. 启用新 bundle，刷新页面，打开 设置 → MCP。

通过命令行安装

dsh plugin --profile web add dsh-mcp-tools      # Web
dsh plugin --profile desktop add dsh-mcp-tools  # Desktop

若设置里没有 MCP 分区，多半是 bundle 未启用：在插件页确认并刷新，必要时重启 dsh web。

典型用法¶

经过上面的安装步骤后，可按 README「快速开始」操作：

1. 进入 设置 → MCP → 添加服务器：远程服务器填 URL，把密钥粘贴进请求头行（默认 x-mcp-key）。
2. 点 测试连接，看到类似「已连接 · 95 个工具 · 478 ms」后保存，并打开服务器开关。
3. 在会话中让模型调用工具；DSH 会将工具注册为 mcp__<服务器>__<工具>。用不到的工具在列表里停用即可——启用的工具越少，每次请求里的 tool schema 越小。

本地 stdio 类服务器则在同一表单里填写命令、参数、环境变量与工作目录；也可粘贴整段 mcpServers JSON 批量导入。

测试连接失败时，README 建议检查：URL、服务器是否使用 streamable-http（而非普通 SSE）、请求头名称是否与服务端一致，以及网络或代理问题。

工作原理简述¶

DeepSeek Harness Web (dsh web)
├── Host 插件（lib/）          ← cordis bundle patch，复用原生 MCP 客户端
│   ├── manager.js             连接、工具注册、启停
│   ├── store.js               ~/.dsh/dsh-mcp-tools/state.json
│   └── routes.js              /mcp-tools/api/*
└── 客户端 bundle（client/client.js）
    └── 设置分区「MCP」

Host 侧提供 REST 接口，例如：GET /mcp-tools/api/state、POST /servers/{test,save,delete,toggle,refresh}、POST /tools/{toggle,bulk}、POST /import、POST /reload、GET /logs（详见仓库 docs/API.md）。

删除 state.json 可重置为空配置，下次启动会自动重建。

适用场景与注意¶

适合谁

• 经常在 DSH 里切换或试验多个 MCP 服务器，希望用图形界面而不是反复改 JSON 的人。
• 接入了工具很多的 MCP，只想把少量工具暴露给模型、控制 schema 体积的人。
• 需要在本机做 MCP 连通性验证、查看最近连接事件的人。

安装前注意

插件以当前 DSH 进程权限运行，会读写本机 ~/.dsh/dsh-mcp-tools/state.json 并连接你配置的 MCP 端点。安装前应阅读 GitHub 仓库 源码与 MIT 许可证，确认密钥与服务器地址符合你的安全策略。SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；插件由社区维护者 hxlog 发布，非 DSH 内置组件。

结尾¶

dsh-mcp-tools 把 MCP 服务器的添加、测试、开关和逐工具启停集中到 DSH 设置里，并强调「停用的工具不进入模型工具列表」，适合在 Harness 里做 MCP 集成与上下文瘦身。进一步了解可访问 SkillHub 目录页 与 GitHub：hxlog/dsh-mcp-tools。