dsh-everything-mcp 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Everything Search MCP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,55 @@
-# Temporary Holding Version
+# dsh-everything-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Instant file and folder search on Windows, powered by [Everything](https://www.voidtools.com/). Ask for a file by name, pattern, folder, size or date and DeepSeek Harness answers from Everything's index — no drive scanning, no waiting.
+
+The plugin gives the assistant two read-only tools — `search` and `status` — and there is nothing else to configure. In DSH they appear as `mcp__everything__search` and `mcp__everything__status`. Under the hood it connects the [Everything Search MCP](https://github.com/EcRal5t/everything-search-mcp) server through DSH's built-in MCP client: no Host plugin, no web UI, no build step, no state.
+
+## Install
+
+```powershell
+dsh plugin --profile <profile> add dsh-everything-mcp
+```
+
+Or install straight from the repository:
+
+```powershell
+dsh plugin --profile <profile> add github:EcRal5t/everything-search-mcp#path:/plugins/dsh-everything-mcp
+```
+
+Restart the profile afterwards. `pnpm` must be on `PATH` — the DSH plugin manager forwards to it.
+
+Manual alternative: add this row to the profile's `cordis.patch.yml`:
+
+```yaml
+- insert:
+    - id: mcp-everything
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: everything
+        transport: stdio
+        command: npx
+        args: ['-y', 'everything-mcp-server']
+```
+
+## Requirements
+
+- **Windows**, with Everything 1.4.1+ or 1.5 running (its index is the search source).
+- **No separate ES command-line client.** The server ships `es.exe` for x64/x86/ARM/ARM64 and auto-detects the running instance over IPC, falling back to HTTP.
+
+## What this server gives you
+
+- **Batch queries.** One call carries 1–8 requests — each with its own `root`, `kind`, `regex`, `sort`, `count`, `offset` and `fields` — so a multi-step search costs one tool round-trip instead of eight.
+- **Compact, token-aware output.** Rows instead of per-hit objects, a bounded result budget, and per-query errors returned in place. Most `es.exe` wrappers spawn once per query and hand back a raw text dump.
+- **Pagination and totals.** `count: 0` returns just the match count, `next_offset` continues, and `fields: ["size"]` adds file-size sums.
+- **Read-only by contract.** Both tools carry `readOnlyHint: true` / `destructiveHint: false`, so they are safe to leave auto-approved.
+- **One server, every client.** The same stdio server is what Codex, OpenCode, Claude Desktop and Cursor use; DSH is just another host.
+
+## Notes
+
+- On DSH 0.2.x the stdio transport is probed once at startup, so the server process is spawned twice. Harmless.
+- DSH scrubs credential-shaped env names (`/KEY|PASSWORD|SECRET|TOKEN/i`) and `DSH_*`. If you need `EVERYTHING_PASSWORD`, put it in the row's `env` instead of the parent environment.
+- Want `@file` completion in DSH? That is a native plugin's job. This bundle deliberately stays a plain MCP bridge, so the same server works in every client.
+
+## License
+
+MIT — see the [repository](https://github.com/EcRal5t/everything-search-mcp) for details.

package/README.zh.md

@@ -0,0 +1,55 @@
+# dsh-everything-mcp
+
+在 Windows 上即时搜索文件和文件夹，底层是 [Everything](https://www.voidtools.com/)。按名称、通配符、目录、大小或日期发问，DeepSeek Harness 直接从 Everything 的索引作答——不扫盘、不等待。
+
+插件给助手两个只读工具 `search` 和 `status`，此外没有需要配置的东西；在 DSH 里显示为 `mcp__everything__search` 和 `mcp__everything__status`。它通过 DSH 内置的 MCP 客户端连接 [Everything Search MCP](https://github.com/EcRal5t/everything-search-mcp) 服务器：没有 Host 插件、没有 Web 界面、不需要构建、不落状态。
+
+## 安装
+
+```powershell
+dsh plugin --profile <profile> add dsh-everything-mcp
+```
+
+也可以直接从仓库安装：
+
+```powershell
+dsh plugin --profile <profile> add github:EcRal5t/everything-search-mcp#path:/plugins/dsh-everything-mcp
+```
+
+安装后重启该 profile。`pnpm` 需要在 `PATH` 上（DSH 插件管理器会转发给它）。
+
+手工方式：在 profile 的 `cordis.patch.yml` 里加这一行：
+
+```yaml
+- insert:
+    - id: mcp-everything
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: everything
+        transport: stdio
+        command: npx
+        args: ['-y', 'everything-mcp-server']
+```
+
+## 前置条件
+
+- **Windows**，Everything 1.4.1+ 或 1.5 正在运行（以它的索引为数据源）。
+- **不需要单独装 ES 命令行**：服务器自带 x64/x86/ARM/ARM64 的 `es.exe`，并自动探测运行中的实例走 IPC，失败时回退 HTTP。
+
+## 这个服务多出来的东西
+
+- **批量查询。** 一次调用带 1–8 个请求，每个请求独立设置 `root`、`kind`、`regex`、`sort`、`count`、`offset`、`fields`——多步搜索只花一次工具往返，而不是八次。
+- **紧凑输出，按 token 预算。** 返回行而非逐条对象，结果有上限，单个请求的错误就地返回。多数 `es.exe` 封装是每次查询起一个进程、回一段原始文本。
+- **分页与总数。** `count: 0` 只取匹配数，`next_offset` 翻页，`fields: ["size"]` 附带文件大小合计。
+- **契约上只读。** 两个工具都带 `readOnlyHint: true` / `destructiveHint: false`，可以放心保持自动批准。
+- **一个服务，所有客户端。** Codex、OpenCode、Claude Desktop、Cursor 用的是同一个 stdio 服务；DSH 只是多一个宿主。
+
+## 说明
+
+- DSH 0.2.x 在启动时会先探测一次 stdio，所以服务进程会被 spawn 两次，无害。
+- DSH 会清掉形似凭据的环境变量名（`/KEY|PASSWORD|SECRET|TOKEN/i`）和 `DSH_*`。需要 `EVERYTHING_PASSWORD` 时，写进这一行的 `env`，别指望父进程环境。
+- 想要 DSH 里的 `@文件` 补全？那是原生插件的事。本包刻意只当 MCP 桥，好让同一个服务在所有客户端里通用。
+
+## 许可
+
+MIT，详见[主仓库](https://github.com/EcRal5t/everything-search-mcp)。

package/cordis.patch.yml

@@ -0,0 +1,28 @@
+# dsh-everything-mcp — the entire integration, in one row.
+#
+# The row below mounts the MCP client bridge that ships inside DeepSeek Harness
+# (`@deepseek-ai/dsh-mcp-client`) and points it at the Everything search MCP
+# server (npm: everything-mcp-server) over stdio. Nothing else is added: no Host
+# plugin, no web route, no state file.
+#
+# The upstream server's tools reach the model as `mcp__everything__<tool>`.
+- insert:
+    - id: mcp-everything
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: everything
+        transport: stdio
+        # `npx` resolves from the PATH of the process that runs DSH. No absolute
+        # path is written here on purpose: this file is shipped to other people's
+        # machines, and a hardcoded user directory is the usual reason a plugin
+        # works for its author and nowhere else.
+        command: npx
+        args:
+          - -y
+          - everything-mcp-server
+        # The server answers from Everything's index; 60 s is already generous.
+        # If you raise EVERYTHING_TIMEOUT_MS past it, raise this too.
+        toolCallTimeoutMs: 60000
+        # A server that cannot start leaves the rest of the harness working and
+        # logs the reason, instead of failing this row at activation.
+        failOnStartupError: false

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "dsh-everything-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Instant file and folder search on Windows with Everything (voidtools), right inside DeepSeek Harness.",
+  "license": "MIT",
+  "author": {
+    "name": "EcRal5t",
+    "url": "https://github.com/EcRal5t"
+  },
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EcRal5t/everything-search-mcp.git",
+    "directory": "plugins/dsh-everything-mcp"
+  },
+  "homepage": "https://github.com/EcRal5t/everything-search-mcp/tree/main/plugins/dsh-everything-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/EcRal5t/everything-search-mcp/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "mcp",
+    "everything",
+    "voidtools",
+    "file-search",
+    "windows",
+    "stdio"
+  ],
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.2.0-rc.1 <0.3.0-0"
+  },
+  "files": [
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}