dsh-mcp-tools

DeepSeek Harness 简洁、优雅的 MCP 工具管理器。
类 Cursor 风格的全局 MCP 控制：自由添加、停用、删除 MCP 接口与工具，适合 MCP 测试、按需请求、拓展上下文等场景。

GitHub 仓库 · npm · 问题反馈 · English

一站式管理用户的 MCP Server，按需开关 MCP Tools。被停用的 MCP 工具不会注册进模型，既不占上下文，也无法被误调用。

✨ 功能

🚀 安装

需要 DeepSeek Harness 0.2.x（Web GUI dsh web 或 DSH Desktop）与 Node.js ≥ 22.13，包已发布到 npm：dsh-mcp-tools。

⚠️ 这是 DeepSeek Harness 插件，不是普通 npm 依赖库：npm i dsh-mcp-tools 只会下载包，运行时仍需装进 DSH profile。

通过插件页安装（推荐）

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

升级包版本后需要重启 dsh web / 重启 DSH Desktop。

dsh plugin add 只负责把包装进 profile，不会自动启用 bundle：装完请在插件页启用一次（这一步会把 dsh-mcp-tools 写进 profile 的 dsh.profile.bundles），或手动确认该列表已包含它，再重启 dsh web。

⚡ 快速开始

1. 设置 → MCP → 添加服务器：远程服务器填 URL，把密钥粘贴进请求头行（默认 x-mcp-key）。
2. 点 测试连接，看到类似 已连接 · 95 个工具 · 478 ms 后保存。先不打开开关也能测试并整理工具：停用状态下的结果行会显示测试结论，工具列表照常出现。
3. 打开服务器开关，DSH 会把启用的工具注册为 mcp__<服务器>__<工具>；用不到的工具展开列表停用即可，启用的工具越少，每次请求里的 tool schema 越小。停用时改的工具开关会在下次启用时生效。

🖼 更多界面

深色模式	停用部分工具

粘贴 mcpServers JSON	工具描述 tooltip

🧩 工作原理

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」（id: mcp，order: 18）—— classic script，无需构建

• 启停生效于注册时而非调用时：停用的工具根本不出现在模型工具列表里。
• 状态存于 ~/.dsh/dsh-mcp-tools/state.json，原子写入；外部修改会被监听并热应用。
• 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。

🔒 安全说明

⚠️ 状态文件等同密码：~/.dsh/dsh-mcp-tools/state.json 里按明文保存 MCP 请求头（通常是 API Key / Token）。不要提交到任何仓库，也不要同步到 iCloud / OneDrive / 云盘或分享给他人；备份时请自行加密。后续版本会考虑接入系统钥匙串（macOS Keychain / Windows DPAPI）。

• 请求头以明文保存在本地状态文件里，只在本机——不要提交到仓库或同步到公开位置。
• 给每个 MCP 服务器使用独立、最小权限的密钥。
• 除你配置的 MCP 服务器外不发起任何网络请求，没有遥测；删除服务器后它的工具会从后续所有请求中移除。

📋 前置要求与权限边界

审核型目录（如 dshplugins.com）要求插件明确列出运行前提、权限与限制，这里统一列出。

• 运行环境：DeepSeek Harness 0.2.x（Web dsh web 或 DSH Desktop），Node.js ≥ 22.13
• 支持平台：DSH Web（--profile web）、DSH Desktop（--profile desktop）；已在 DSH 0.2.1-rc.2 实机验证
• 文件访问：仅读写插件自身状态文件 ~/.dsh/dsh-mcp-tools/state.json
• 网络：仅访问你自己填写的 MCP 端点（streamable-http 服务器与「测试连接」）；无遥测、不上报任何数据
• 进程：仅当你显式添加 stdio 服务器时，由 MCP 客户端启动你填写的命令（参数、环境变量、工作目录均由你填写）
• UI 注入：设置页「设置 → MCP」面板，依赖 @deepseek-ai/dsh-client-ui-settings 与 @deepseek-ai/dsh-client-locale

已知限制

• MCP 请求头以明文保存在 state.json（尚未接入系统钥匙串），备份/同步时请自行加密
• 仅支持 streamable-http 与 stdio 两种传输，不支持旧版 SSE
• 只管理当前 DSH profile 里的 MCP 服务器；切换 profile 需在对应 profile 重新添加
• 没有后台自动健康检查，需要时手动点「测试连接」
• 停用状态下的「测试连接 / 刷新工具」会临时建立一次连接（stdio 服务器会启动一次进程），只用于发现工具，不会注册给模型
• 单条 tooltip 最宽 320px（窄屏按视口收窄），长描述在气泡内换行

🛠 开发

git clone https://github.com/hxlog/dsh-mcp-tools.git
cd dsh-mcp-tools
node --check client/client.js
npm test            # 静态检查
npm run test:manager # 离线 manager 集成测试（需要本机已装 DSH，缺失时自动 SKIP）

把源码目录链接进 profile 调试（Windows 示例）：

rmdir "C:\Users\<你>\.dsh\profiles\web\node_modules\dsh-mcp-tools"
mklink /J "C:\Users\<你>\.dsh\profiles\web\node_modules\dsh-mcp-tools" "D:\path\to\dsh-mcp-tools"

• 客户端改动：刷新页面即可，bundle 直接从磁盘提供，无构建。
• Host 改动：改一次 profile 的 cordis.patch.yml（例如追加一行注释）触发 HMR 重组，日志出现 MCP 管理器已启动 即生效。
• 面板是单个 classic script，只能 require react 与 @deepseek-ai/dsh-client-ui-primitives。

❓ 常见问题

📄 License

MIT · Powered by DeepSeek Harness