npm - dsh-mcp-tools - Versions diffs - 1.0.0 → 1.0.2 - Mend

dsh-mcp-tools 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.en.md +85 -125
package/README.md +84 -125
package/docs/screenshots/zh/mcp-detail.png +0 -0
package/package.json +3 -3
package/scripts/smoke.mjs +2 -2

package/README.en.md CHANGED Viewed

@@ -1,143 +1,111 @@
-# dsh-mcp-tools
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/logo.png" width="72" height="72" alt="dsh-mcp-tools" />
+</p>
-**The most minimal, elegant MCP tool manager for DeepSeek Harness.**
+<h1 align="center">dsh-mcp-tools</h1>
-[![npm](https://img.shields.io/npm/v/dsh-mcp-tools?color=black)](https://www.npmjs.com/package/dsh-mcp-tools)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-mcp-tools?color=black)](https://www.npmjs.com/package/dsh-mcp-tools)
-[![license](https://img.shields.io/badge/license-MIT-black.svg)](LICENSE)
-[![node](https://img.shields.io/badge/node-%3E%3D22.13-black.svg)](https://nodejs.org)
+<p align="center">
+  <b>The most minimal, elegant MCP tool manager for DeepSeek Harness.</b><br />
+  Cursor-style global MCP control: add, disable and remove MCP servers and tools freely — for MCP testing, on-demand requests and context expansion.
+</p>
-English | [简体中文](README.md)
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-mcp-tools"><img src="https://img.shields.io/npm/v/dsh-mcp-tools?color=black" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/dsh-mcp-tools"><img src="https://img.shields.io/npm/dm/dsh-mcp-tools?color=black" alt="npm downloads" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-black.svg" alt="license" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D22.13-black.svg" alt="node" /></a>
+  <a href="https://github.com/hxlog/dsh-mcp-tools"><img src="https://img.shields.io/badge/GitHub-hxlog%2Fdsh--mcp--tools-black?logo=github" alt="GitHub" /></a>
+</p>
-Manage your MCP servers and toggle MCP tools on demand, inside the DeepSeek Harness Web GUI. Disabled tools **never reach the model**: no context cost, no accidental calls.
+<p align="center">
+  <a href="https://github.com/hxlog/dsh-mcp-tools">GitHub</a> ·
+  <a href="https://www.npmjs.com/package/dsh-mcp-tools">npm</a> ·
+  <a href="https://github.com/hxlog/dsh-mcp-tools/issues">Issues</a> ·
+  <a href="README.md">简体中文</a>
+</p>
-![MCP servers in Settings](docs/screenshots/en/mcp-overview.png)
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/en/mcp-overview.png" width="70%" alt="MCP servers in Settings" />
+</p>
----
+> All-in-one MCP server management with per-tool switches. Disabled tools **never reach the model**: no context cost, no accidental calls.
-## Why this exists
+## ✨ Features
-MCP servers are great until a single "all-in-one" server drops 95 tools into every request. DSH's native configuration is a YAML/JSON file: editing it means restarting or recomposing the profile, and there is no way to say *"keep this server, but give the model only 12 of its tools."*
+| Capability | Details |
+| --- | --- |
+| **Server management** | Two transports: `streamable-http` (URL + headers) and `stdio` (command / args / env / cwd); fill fields or paste `{"mcpServers": { ... }}` to import many at once. |
+| **Postman-style secrets** | Headers are key/value rows, not a JSON textarea; a default `x-mcp-key` row is provided, values are masked and can be revealed per row, duplicate names error inline. |
+| **Real per-tool control** | Every tool is a chip; disable it and it disappears from the model's tool list entirely (not "registered then errors"). Search, select all, invert, disable all — hover for the full description. |
+| **Connectivity test & event log** | Temporary connection: `initialize → tools/list → close`, reporting latency / protocol version / tool count without touching the live server. The "Recent events" log records connects, reloads, tests and failures. |
+| **Server toggle & config copy** | Turning a server off disconnects it and unregisters all its tools (config kept); one click copies that server's `mcpServers` snippet. |
+| **Native DSH look** | Reuses `--dsw-*` design tokens, flat rows and 32px inputs; light/dark and zh/en adapt automatically. The client is a classic script — no build step. |
-dsh-mcp-tools moves all of that into **Settings → MCP**:
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/en/mcp-add-server.png" width="48%" alt="Add server: key/value headers" />
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/en/mcp-tools.png" width="48%" alt="Per-tool chips" />
+</p>
-- add, edit, disable and delete servers without touching config files;
-- paste secrets as Postman-style key/value headers (headers stay on your machine);
-- verify connectivity and see the tool count before enabling anything;
-- toggle tools per server, with search, select-all, invert and disable-all.
+## 🚀 Install
----
+Requires **DeepSeek Harness 0.2.x** (Web GUI `dsh web` or DSH Desktop) and **Node.js ≥ 22.13**. Available on npm: [dsh-mcp-tools](https://www.npmjs.com/package/dsh-mcp-tools).
-## Features
+> ⚠️ This is a **DeepSeek Harness plugin**, not a plain npm library: `npm i dsh-mcp-tools` only downloads the package — it still has to be installed into a DSH profile as below.
-### Server management
+**From the Plugins page (recommended)**
-- **Two transports**: `streamable-http` (URL + headers) and `stdio` (command, args, env, cwd).
-- **Two ways to add**: fill in fields, or paste an `{"mcpServers": { ... }}` block — the same shape DSH and Claude Desktop use — to import several servers at once.
-- **Server switch**: turning a server off disconnects it and unregisters all of its tools. Nothing is deleted.
-- **Copy config**: one click copies that server back out as an `mcpServers` snippet.
-### Secrets, the Postman way
-Header rows are key/value pairs, not a JSON textarea. A new server starts with an `x-mcp-key` row: paste the secret into the value column and save.
-![Adding a server with key/value headers](docs/screenshots/en/mcp-add-server.png)
-Values are masked by default and can be revealed per row. Duplicate header names are rejected inline. Prefer JSON? Switch to **Paste JSON** — it syncs name, URL, transport and headers back into the form.
-![Pasting an mcpServers JSON block](docs/screenshots/en/mcp-json-import.png)
-### Real per-tool control
-Every tool is a chip. Click to disable; the tool disappears from the model's tool list immediately (it is not registered at all). Search, select all, invert, disable all.
-![Per-tool chips](docs/screenshots/en/mcp-tools.png)
-Hover a chip for its full description, even while the server is disabled.
-![Tool description tooltip](docs/screenshots/en/mcp-tooltip.png)
-### Connectivity test and event log
-The test button opens a throwaway connection: `initialize` → `tools/list` → close. It reports latency, protocol version and tool count, and never mutates the running server. A compact event log records connects, reloads, tests and failures.
-### Native fit
-Same design tokens (`--dsw-*`), same flat rows, same 32px inputs as DSH itself. Light and dark, Chinese and English, keyboard focus rings included. No build step: the client bundle is a classic script that only requires `react` and the official UI primitives.
-See it in dark mode:
-![MCP manager in dark mode](docs/screenshots/en/mcp-dark.png)
-![Disabled tools](docs/screenshots/en/mcp-tool-toggles.png)
----
-## Install
-Requires **DeepSeek Harness 0.2.x** with the Web GUI (`dsh web`) and **Node.js ≥ 22.13**.
-### From the Plugins page (recommended)
-1. Open the DSH Web GUI → **Plugins** in the sidebar.
+1. Open DSH Web (or DSH Desktop) → **Plugins** in the sidebar (Desktop: **Settings → Plugins**).
 2. Choose **Install**, enter `dsh-mcp-tools`, and confirm.
-3. Enable the new bundle, then refresh the page once.
-4. Open **Settings → MCP**.
+3. Enable the new bundle, refresh the page, then open **Settings → MCP**.
-### From the CLI
+**From the CLI**
 ```bash
-dsh plugin --profile web add dsh-mcp-tools
+dsh plugin --profile web add dsh-mcp-tools      # Web
+dsh plugin --profile desktop add dsh-mcp-tools  # Desktop
 ```
-Then add `"dsh-mcp-tools"` to `dsh.profile.bundles` in `~/.dsh/profiles/web/package.json` (or enable the bundle on the Plugins page) and refresh. If the section does not appear, restart `dsh web`.
-> Upgrading the package requires a restart of `dsh web` to load the new host module generation.
+> Upgrading the package requires a restart of `dsh web` / reopening DSH Desktop.
----
+## ⚡ Quick start
-## Quick start
+1. **Settings → MCP → Add server**: for remote servers enter the URL and paste the secret into the header row (default `x-mcp-key`).
+2. Hit **Test connection** — expect something like `connected · 95 tools · 478 ms` — then save and flip the server switch on.
+3. Let the model call the tools; DSH registers them as `mcp__<server>__<tool>`. Disable unused tools to shrink the tool schema in every request.
-1. **Settings → MCP → Add server.**
-2. For a remote server: paste its URL, then put the key in the header row (`x-mcp-key` by default).
-3. Hit **Test connection** — you should see something like `Connected · 95 tools · 478 ms`.
-4. Save. Enable the server if it is not on yet.
-5. In a session, ask the model to use a tool. DSH registers each one as `mcp__<server>__<tool>`.
+## 🖼 More screenshots
-To trim context, open the server's tools and disable what you do not need. Fewer enabled tools means a smaller tool schema in every request.
+| Dark mode | Some tools disabled |
+| --- | --- |
+| <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/en/mcp-dark.png" width="100%" alt="Dark mode" /> | <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/en/mcp-tool-toggles.png" width="100%" alt="Some tools disabled" /> |
----
+| Paste `mcpServers` JSON | Tool tooltip |
+| --- | --- |
+| <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/en/mcp-json-import.png" width="100%" alt="Paste mcpServers JSON" /> | <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/en/mcp-tooltip.png" width="100%" alt="Tool tooltip" /> |
-## How it works
+## 🧩 How it works
 ```
 DeepSeek Harness Web (dsh web)
-├── Host plugin  (lib/)            ← cordis bundle patch, native MCP client
-│   ├── manager.js                 connections, tool registry, enable/disable
-│   ├── store.js                   ~/.dsh/dsh-mcp-tools/state.json (atomic, watched)
-│   └── routes.js                  /mcp-tools/api/*
+├── Host plugin (lib/)          ← cordis bundle patch, reuses the native MCP client
+│   ├── manager.js              connect, register tools, enable/disable
+│   ├── store.js                ~/.dsh/dsh-mcp-tools/state.json (atomic writes, watches external edits)
+│   └── routes.js               /mcp-tools/api/*
 └── Client bundle (client/client.js)
     └── Settings section "MCP" (id: mcp, order: 18) — classic script, no build
 ```
-- The host plugin wraps DSH's native MCP client, so tools appear in sessions exactly like hand-configured ones (`mcp__server__tool`).
-- Enablement is enforced at **registration** time, not on call: a disabled tool is absent from the model's tool list.
-- State lives in `~/.dsh/dsh-mcp-tools/state.json`, written atomically. External edits are picked up and applied live.
-REST surface (used by the panel, also scriptable): `GET /mcp-tools/api/state`, `POST /servers/{test,save,delete,toggle,refresh}`, `POST /tools/{toggle,bulk}`, `POST /import`, `POST /reload`, `GET /logs`. See [docs/API.md](docs/API.md).
----
+- Enable/disable happens at **registration** time, not call time: disabled tools never appear in the model's tool list.
+- State lives in `~/.dsh/dsh-mcp-tools/state.json`, written atomically; external edits are watched and hot-applied.
+- REST API: `GET /mcp-tools/api/state`, `POST /servers/{test,save,delete,toggle,refresh}`, `POST /tools/{toggle,bulk}`, `POST /import`, `POST /reload`, `GET /logs`. See [docs/API.md](docs/API.md).
-## Security notes
+## 🔒 Security
-- Server headers are stored **in plaintext** in the local state file. The file is yours, on your machine — do not commit it or sync it to a public location.
-- Use a dedicated, least-privilege key per MCP server.
-- The plugin makes no network calls except to the MCP servers you configure. No telemetry.
-- Deleting a server removes its tools from every future request.
+- Headers are stored **in plain text** in the local state file — local only; never commit or sync it to a public location.
+- Use a dedicated, least-privilege key for every MCP server.
+- No network requests beyond the MCP servers you configure, and no telemetry; deleting a server removes its tools from subsequent requests.
----
-## Development
+## 🛠 Development
 ```bash
 git clone https://github.com/hxlog/dsh-mcp-tools.git
@@ -146,36 +114,28 @@ node --check client/client.js
 npm run selftest
 ```
-For live development, link the checkout into your profile instead of installing a copy (Windows example):
+Link the source tree into a profile instead of installing a copy (Windows example):
 ```bat
 rmdir "C:\Users\<you>\.dsh\profiles\web\node_modules\dsh-mcp-tools"
 mklink /J "C:\Users\<you>\.dsh\profiles\web\node_modules\dsh-mcp-tools" "D:\path\to\dsh-mcp-tools"
 ```
-- **Client changes**: refresh the page. The bundle is served from disk, no build involved.
-- **Host changes**: touch the profile's `cordis.patch.yml` (e.g. append a comment) to trigger HMR recomposition; the log line `MCP manager started` confirms it.
-The panel is written as a single classic script because DSH's Web loader evaluates client bundles as classic scripts. Only `react` and `@deepseek-ai/dsh-client-ui-primitives` may be required.
----
-## FAQ
-**The MCP section is missing.** The bundle is probably not enabled. Check Plugins → the bundle, refresh, and restart `dsh web` if needed.
-**Tools do not show up in a session.** Make sure the server is enabled and the individual tool chips are on. Disabled tools are never registered.
-**Test connection fails.** Verify the URL, that the server speaks `streamable-http` (not plain SSE), and that the header name matches what the server expects. Network/proxy issues surface here too.
-**Where is the state?** `~/.dsh/dsh-mcp-tools/state.json`. Deleting it resets everything to empty; the plugin recreates it on next launch.
+- **Client changes**: just refresh the page; the bundle is served from disk, no build.
+- **Host changes**: touch the profile's `cordis.patch.yml` (e.g. append a comment) to trigger HMR; once the log shows `MCP 管理器已启动` it is active.
+- The panel is a single classic script and may only `require` `react` and `@deepseek-ai/dsh-client-ui-primitives`.
----
+## ❓ FAQ
-## License
+| Question | Answer |
+| --- | --- |
+| No MCP section in Settings | The bundle is probably not enabled — confirm on the Plugins page, refresh, restart `dsh web` if needed. |
+| Tools missing in a session | Make sure the server switch is on and the tool chips are enabled; disabled tools are never registered. |
+| Connection test fails | Check the URL, that the server speaks `streamable-http` (not plain SSE), and the header names; network/proxy problems surface here too. |
+| Where is the state file? | `~/.dsh/dsh-mcp-tools/state.json`; delete it to reset to empty — it is recreated on next start. |
-[MIT](LICENSE)
+## 📄 License
----
+[MIT](LICENSE) · Powered by [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
 [![](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)

package/README.md CHANGED Viewed

@@ -1,145 +1,112 @@
-# dsh-mcp-tools
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/logo.png" width="72" height="72" alt="dsh-mcp-tools" />
+</p>
-**DeepSeek Harness 最简洁、优雅的MCP工具管理器。**
+<h1 align="center">dsh-mcp-tools</h1>
-[![npm](https://img.shields.io/npm/v/dsh-mcp-tools?color=black)](https://www.npmjs.com/package/dsh-mcp-tools)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-mcp-tools?color=black)](https://www.npmjs.com/package/dsh-mcp-tools)
-[![license](https://img.shields.io/badge/license-MIT-black.svg)](LICENSE)
-[![node](https://img.shields.io/badge/node-%3E%3D22.13-black.svg)](https://nodejs.org)
+<p align="center">
+  <b>DeepSeek Harness 简洁、优雅的 MCP 工具管理器。</b><br />
+  类 Cursor 风格的全局 MCP 控制：自由添加、停用、删除 MCP 接口与工具，适合 MCP 测试、按需请求、拓展上下文等场景。
+</p>
-[English](README.en.md) | 简体中文
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-mcp-tools"><img src="https://img.shields.io/npm/v/dsh-mcp-tools?color=black" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/dsh-mcp-tools"><img src="https://img.shields.io/npm/dm/dsh-mcp-tools?color=black" alt="npm downloads" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-black.svg" alt="license" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D22.13-black.svg" alt="node" /></a>
+  <a href="https://github.com/hxlog/dsh-mcp-tools"><img src="https://img.shields.io/badge/GitHub-hxlog%2Fdsh--mcp--tools-black?logo=github" alt="GitHub" /></a>
+</p>
-管理用户的 MCP Server，按需开关 MCP Tools。被停用的工具**不会注册进模型**，既不占上下文，也无法被误调用。
+<p align="center">
+  <a href="https://github.com/hxlog/dsh-mcp-tools">GitHub 仓库</a> ·
+  <a href="https://www.npmjs.com/package/dsh-mcp-tools">npm</a> ·
+  <a href="https://github.com/hxlog/dsh-mcp-tools/issues">问题反馈</a> ·
+  <a href="README.en.md">English</a>
+</p>
-![设置中的 MCP 服务器](docs/screenshots/zh/mcp-overview.png)
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/zh/mcp-overview.png" width="49%" alt="设置服务器" />
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/zh/mcp-detail.png" width="49%" alt="MCP 工具详情" />
+</p>
----
+> 一站式管理用户的 MCP Server，按需开关 MCP Tools。被停用的 MCP 工具**不会注册进模型**，既不占上下文，也无法被误调用。
-## 为什么做这个
+## ✨ 功能
-MCP 很好用，直到某个「全家桶」服务器把 95 个工具塞进每一次请求。DSH 原生配置是 YAML/JSON 文件：改一次要重组 profile 甚至重启，而且没法表达「保留这个服务器，但只给模型 12 个工具」。
+| 能力 | 说明 |
+| --- | --- |
+| **服务器管理** | 两种传输：`streamable-http`（URL + 请求头）与 `stdio`（命令 / 参数 / 环境变量 / 工作目录）；分字段填写，或直接粘贴 `{"mcpServers": { ... }}` 一次导入多个。 |
+| **像 Postman 一样填密钥** | 请求头是键值对行而不是 JSON 文本框，默认带一行 `x-mcp-key`；值默认掩码、可逐行显示；名称重复就地报错。 |
+| **真正的逐工具控制** | 每个工具是一个 chip，点击即从模型工具列表消失（不是注册了再报错）；支持搜索 / 全选 / 反选 / 全部停用，悬停查看完整描述。 |
+| **连通性测试与事件日志** | 临时建连 `initialize → tools/list → 关闭`，回报耗时 / 协议版本 / 工具数，不影响运行中的服务器；「最近事件」记录连接、重载、测试与失败。 |
+| **服务器开关与配置复制** | 关闭服务器即断开并注销其全部工具（不删配置）；一键复制该服务器的 `mcpServers` 片段。 |
+| **与 DSH 原生一致** | 沿用 `--dsw-*` 设计 token、平铺行与 32px 输入框，深浅色 / 中英文自适应；客户端是 classic script，无构建步骤。 |
-dsh-mcp-tools 把这些搬进了 **设置 → MCP**：
+<p align="center">
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/zh/mcp-add-server.png" width="48%" alt="添加服务器：键值对请求头" />
+  <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/zh/mcp-tools.png" width="48%" alt="逐工具 chip" />
+</p>
-- 增删改停服务器，不碰配置文件；
-- 请求头按 Postman 的方式一行一个键值对，密钥只留在本机；
-- 启用前先验证连通性和工具数量；
-- 按服务器逐工具开关，支持搜索、全选、反选、全部停用。
+## 🚀 安装
----
+需要 **DeepSeek Harness 0.2.x**（Web GUI `dsh web` 或 DSH Desktop）与 **Node.js ≥ 22.13**，包已发布到 npm：[dsh-mcp-tools](https://www.npmjs.com/package/dsh-mcp-tools)。
-## 功能
+> ⚠️ 这是 **DeepSeek Harness 插件**，不是普通 npm 依赖库：`npm i dsh-mcp-tools` 只会下载包，运行时仍需装进 DSH profile。
-### 服务器管理
+**通过插件页安装（推荐）**
-- **两种传输**：`streamable-http`（URL + 请求头）与 `stdio`（命令、参数、环境变量、工作目录）。
-- **两种录入**：分字段填写，或直接粘贴 `{"mcpServers": { ... }}`（与 DSH 原生配置同格式），一次导入多个服务器。
-- **服务器开关**：关闭即断开连接并注销该服务器全部工具，不会删除配置。
-- **复制配置**：一键复制该服务器的 `mcpServers` 片段。
-### 像 Postman 一样填密钥
-请求头是键值对行，而不是 JSON 文本框。新服务器默认带一行 `x-mcp-key`，把密钥粘进「值」即可保存。
-![添加服务器：键值对请求头](docs/screenshots/zh/mcp-add-server.png)
-值默认掩码显示，可逐行切换显示；名称重复会就地报错。也可以切到「粘贴 JSON」——解析后会把名称、URL、传输方式和请求头同步回表单。
-![粘贴 mcpServers JSON](docs/screenshots/zh/mcp-json-import.png)
-### 真正的逐工具控制
-每个工具是一个 chip。点击即停用，工具会立刻从模型工具列表中消失（不是注册了再报错）。支持搜索、全选、反选、全部停用。
-![逐工具 chip](docs/screenshots/zh/mcp-tools.png)
-悬停 chip 可查看完整描述，服务器停用时也能看。
-![工具描述 tooltip](docs/screenshots/zh/mcp-tooltip.png)
-### 连通性测试与事件日志
-测试按钮会临时建连：`initialize` → `tools/list` → 关闭，回报耗时、协议版本与工具数量，不改动正在运行的服务器。下方「最近事件」记录连接、重载、测试与失败。
-### 与 DSH 原生一致
-沿用 `--dsw-*` 设计 token、平铺行、32px 输入框，深浅色与中英文自适应，键盘焦点环完整。客户端没有构建步骤：它是 classic script，只依赖 `react` 与官方 UI primitives。
-深色模式：
-![深色模式](docs/screenshots/zh/mcp-dark.png)
-停用部分工具：
-![停用工具](docs/screenshots/zh/mcp-tool-toggles.png)
----
-## 安装
-需要 **DeepSeek Harness 0.2.x**（Web GUI，`dsh web`）与 **Node.js ≥ 22.13**。
-### 通过插件页安装（推荐）
-1. 打开 DSH Web GUI → 侧边栏 **插件**。
+1. 打开 DSH Web（或 DSH Desktop）→ 侧边栏 **插件**（Desktop 在 **设置 → 插件**）。
 2. 点击安装，填入 `dsh-mcp-tools`，确认。
-3. 启用新 bundle，然后刷新一次页面。
-4. 打开 **设置 → MCP**。
+3. 启用新 bundle，刷新页面，打开 **设置 → MCP**。
-### 通过命令行安装
+**通过命令行安装**
 ```bash
-dsh plugin --profile web add dsh-mcp-tools
+dsh plugin --profile web add dsh-mcp-tools      # Web
+dsh plugin --profile desktop add dsh-mcp-tools  # Desktop
 ```
-然后把 `"dsh-mcp-tools"` 加进 `~/.dsh/profiles/web/package.json` 的 `dsh.profile.bundles`（或在插件页启用该 bundle），刷新页面。若分区仍未出现，重启 `dsh web`。
-> 升级包版本后需要重启 `dsh web`，才会加载新的 host 模块。
+> 升级包版本后需要重启 `dsh web` / 重启 DSH Desktop。
----
+## ⚡ 快速开始
-## 快速开始
+1. **设置 → MCP → 添加服务器**：远程服务器填 URL，把密钥粘贴进请求头行（默认 `x-mcp-key`）。
+2. 点 **测试连接**，看到类似 `已连接 · 95 个工具 · 478 ms` 后保存，并打开服务器开关。
+3. 在会话中直接让模型调用工具，DSH 会注册为 `mcp__<服务器>__<工具>`；用不到的工具展开列表停用即可，启用的工具越少，每次请求里的 tool schema 越小。
-1. **设置 → MCP → 添加服务器**。
-2. 远程服务器：填 URL，把密钥粘贴进请求头行（默认 `x-mcp-key`）。
-3. 点 **测试连接**，应看到类似 `已连接 · 95 个工具 · 478 ms`。
-4. 保存，并打开服务器开关。
-5. 在会话中直接让模型调用工具。DSH 会把它注册为 `mcp__<服务器>__<工具>`。
+## 🖼 更多界面
-想省上下文，就展开工具列表，把用不到的停用。启用的工具越少，每次请求里的工具 schema 越小。
+| 深色模式 | 停用部分工具 |
+| --- | --- |
+| <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/zh/mcp-dark.png" width="100%" alt="深色模式" /> | <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/zh/mcp-tool-toggles.png" width="100%" alt="停用部分工具" /> |
----
+| 粘贴 mcpServers JSON | 工具描述 tooltip |
+| --- | --- |
+| <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/zh/mcp-json-import.png" width="100%" alt="粘贴 mcpServers JSON" /> | <img src="https://cdn.jsdelivr.net/gh/hxlog/dsh-mcp-tools@main/docs/screenshots/zh/mcp-tooltip.png" width="100%" alt="工具描述 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/*
+├── 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，无需构建
 ```
-- Host 插件包装 DSH 原生 MCP 客户端，工具与会话的接入方式与手写配置完全一致（`mcp__服务器__工具`）。
 - 启停生效于**注册时**而非调用时：停用的工具根本不出现在模型工具列表里。
-- 状态在 `~/.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](docs/API.md)。
----
+- 状态存于 `~/.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](docs/API.md)。
-## 安全说明
+## 🔒 安全说明
-- 服务器请求头以**明文**保存在本地状态文件里。文件只在本机，请不要提交到仓库或同步到公开位置。
+- 请求头以**明文**保存在本地状态文件里，只在本机——不要提交到仓库或同步到公开位置。
 - 给每个 MCP 服务器使用独立、最小权限的密钥。
-- 插件除你配置的 MCP 服务器外不发起任何网络请求，没有遥测。
-- 删除服务器后，它的工具会从后续所有请求中移除。
+- 除你配置的 MCP 服务器外不发起任何网络请求，没有遥测；删除服务器后它的工具会从后续所有请求中移除。
----
-## 开发
+## 🛠 开发
 ```bash
 git clone https://github.com/hxlog/dsh-mcp-tools.git
@@ -148,36 +115,28 @@ node --check client/client.js
 npm run selftest
 ```
-调试时把源码目录链接进 profile，而不是安装副本（Windows 示例）：
+把源码目录链接进 profile 调试（Windows 示例）：
 ```bat
 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，因为 DSH Web loader 以 classic script 方式执行客户端 bundle。只能 require `react` 与 `@deepseek-ai/dsh-client-ui-primitives`。
----
-## 常见问题
-**设置里没有 MCP 分区。** 多半是 bundle 未启用：去插件页确认并刷新页面，必要时重启 `dsh web`。
-**会话里看不到工具。** 确认服务器开关已打开、对应工具 chip 也是启用状态；停用的工具不会被注册。
-**测试连接失败。** 检查 URL、服务器是否使用 `streamable-http`（而非普通 SSE）、请求头名称是否与服务端要求一致；网络/代理问题也会在这里暴露。
-**状态文件在哪？** `~/.dsh/dsh-mcp-tools/state.json`。删除即重置为空，下次启动会自动重建。
+- **客户端改动**：刷新页面即可，bundle 直接从磁盘提供，无构建。
+- **Host 改动**：改一次 profile 的 `cordis.patch.yml`（例如追加一行注释）触发 HMR 重组，日志出现 `MCP 管理器已启动` 即生效。
+- 面板是单个 classic script，只能 `require` `react` 与 `@deepseek-ai/dsh-client-ui-primitives`。
----
+## ❓ 常见问题
-## License
+| 问题 | 处理 |
+| --- | --- |
+| 设置里没有 MCP 分区 | 多半是 bundle 未启用：插件页确认并刷新，必要时重启 `dsh web`。 |
+| 会话里看不到工具 | 确认服务器开关已打开、对应工具 chip 也已启用；停用的工具不会被注册。 |
+| 测试连接失败 | 检查 URL、服务器是否使用 `streamable-http`（而非普通 SSE）、请求头名称是否与服务端要求一致；网络 / 代理问题也会在这里暴露。 |
+| 状态文件在哪 | `~/.dsh/dsh-mcp-tools/state.json`；删除即重置为空，下次启动自动重建。 |
-[MIT](LICENSE)
+## 📄 License
----
+[MIT](LICENSE) · Powered by [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
 [![](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)

package/docs/screenshots/zh/mcp-detail.png ADDED Viewed

Binary file

package/package.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "name": "dsh-mcp-tools",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
-  "description": "Manage your MCP servers and toggle MCP tools on demand, inside DeepSeek Harness settings.",
+  "description": "Manage your MCP servers and toggle MCP tools on demand inside DeepSeek Harness settings",
   "icon": "icon.svg",
   "main": "./lib/index.js",
   "exports": {
@@ -51,7 +51,7 @@
   },
   "license": "MIT",
   "author": "Xingyu Liu <xingyuliu@outlook.sg>",
-  "homepage": "https://github.com/hxlog/dsh-mcp-tools#readme",
+  "homepage": "https://github.com/hxlog/dsh-mcp-tools",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hxlog/dsh-mcp-tools.git"

package/scripts/smoke.mjs CHANGED Viewed

@@ -63,8 +63,8 @@ check('README screenshots exist (zh primary + en)', () => {
 })
 check('Chinese README is the npm/GitHub landing page', () => {
   const text = read('README.md')
-  assert(text.includes('DeepSeek Harness 最简洁'), 'tagline missing from README.md')
-  assert(text.includes('[English](README.en.md)'), 'language switch missing from README.md')
+  assert(text.includes('DeepSeek Harness 简洁'), 'tagline missing from README.md')
+  assert(text.includes('README.en.md'), 'language switch missing from README.md')
 })
 check('npm files whitelist contains runtime paths', () => {
   for (const entry of ['lib', 'client/client.js', 'locale', 'cordis.patch.yml', 'icon.svg', 'README.md', 'README.en.md', 'LICENSE']) {