Everything Search MCP

io.github.EcRal5t由 GitHub 账号 EcRal5t 发布v0.1.0更新于 Oct 31, 2026

Fast file search on Windows with Everything. Find files, browse folders, and compare sizes.

已验证STDIO仅桌面文件与存储开发者工具

概览

AI 生成的概览

让助手通过 Everything 索引搜索 Windows 磁盘：按名称、路径、类型、大小或日期查找文件与文件夹，浏览目录并比较大小。

可以做什么
  • 按名称、路径、类型、大小或日期在已索引磁盘中搜索文件与文件夹，支持正则、排序与分页
  • 列出某个目录的直接子项，或在指定根路径下递归搜索
  • 统计匹配数量与总字节数，或返回大小、时间戳、属性、运行次数等附加元数据
  • 一次请求提交最多八条查询，并检查后端连接、Everything 版本、所选实例与索引就绪状态
适用场景
适用于 Windows 上需要让助手定位本地或已索引磁盘中的文件与文件夹、排查大文件、查找项目产物，或比较文件夹大小的场景，无需用户手动描述目录结构。
运行要求
Windows（x64、x86、ARM64、ARM），已安装并运行 Everything 1.4.1+ 或 1.5 Alpha；Node.js v22.0.0 或更高版本；npm 包以 stdio 在本地运行，通常经 cmd.exe 用 npx 启动。可选环境变量用于指定自定义实例（EVERYTHING_INSTANCE）、Everything HTTP 服务（EVERYTHING_URL 及 EVERYTHING_USERNAME、EVERYTHING_PASSWORD）、结果上限、输出预算、超时和 es.exe 路径。
安装前请注意
两个工具均声明为只读，但搜索结果会把用户磁盘上的文件路径、名称、大小和时间戳暴露给助手及其模型提供方。若设置 EVERYTHING_URL，凭据通过 EVERYTHING_USERNAME 和 EVERYTHING_PASSWORD 提供，应避免写入共享配置文件。HTTP 后端支持的排序字段和元数据少于本地 IPC。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Everything Search MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Everything Search MCP

简体中文

Search Windows files from your AI assistant using Everything.

Find files across indexed drives by name, path, type, size, or date. Browse folders, compare their sizes, and get counts or total file sizes in a single request. Searches use Everything's existing index, with paginated results and optional metadata.

Prerequisites

  • OS: Windows (x64, x86, ARM64, ARM)
  • Node.js: v22.0.0 or newer
  • Everything: Everything 1.4.1+ or 1.5 Alpha installed and running.

The ES helper is included. The server automatically checks the default Everything instance, 1.5a, and 1.5 and connects through local IPC.

Installation & Configuration

On Windows, launch npx through cmd.exe as shown below. Choose your client, add the configuration, then reload its MCP connections. (DeepSeek Harness is the exception: it spawns the command directly, so plain npx works — see its section below.)

[Install in Cursor]

OpenAI Codex

Add to your Codex configuration file (%USERPROFILE%/.codex/config.toml or project-level .codex/config.toml):

toml
[mcp_servers.everything]command = "cmd.exe"args = ["/d", "/c", "npx", "-y", "everything-mcp-server"]

Or add via Codex CLI:

powershell
codex mcp add everything -- cmd.exe /d /c npx -y everything-mcp-server
OpenCode

Add to your project's opencode.json:

json
{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "everything": {      "type": "local",      "command": ["cmd.exe", "/d", "/c", "npx", "-y", "everything-mcp-server"]    }  }}

Or run the OpenCode setup wizard and enter the command above:

powershell
opencode mcp add
DeepSeek Harness

Install the plugin, then restart the profile:

powershell
dsh plugin --profile <profile> add dsh-everything-mcp

Or install straight from this repository:

powershell
dsh plugin --profile <profile> add github:EcRal5t/everything-search-mcp#path:/plugins/dsh-everything-mcp

The tools appear as mcp__everything__search and mcp__everything__status. To wire it by hand instead, 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']

DSH spawns commands directly, so no cmd.exe wrapper is needed. See plugins/dsh-everything-mcp for the bundle itself.

Claude Desktop and other MCP clients

Add to your MCP client configuration (e.g. claude_desktop_config.json):

json
{  "mcpServers": {    "everything": {      "command": "cmd.exe",      "args": ["/d", "/c", "npx", "-y", "everything-mcp-server"]    }  }}

VS Code uses servers as the top-level key.

What to ask

After connecting, ask your assistant to use Everything for tasks such as:

  • Locate a missing file: “Find quarterly-report PDFs modified last month across my indexed drives.”
  • Investigate large files: “Show the ten largest log files or archives over 1 GB on C:, including their paths and sizes.”
  • Find project artifacts: “Find folders named node_modules or target under D:/Projects and tell me how many there are.”
  • Compare folder sizes: “Compare the sizes of the folders directly inside D:/Projects.”

Tools

Both tools are read-only.

ToolPurpose
searchFind paths, browse folders, count matches, and retrieve sizes or other indexed metadata.
statusCheck the connection, selected Everything instance, and version.

Connection settings

Default settings cover common local installations. Use EVERYTHING_INSTANCE for a custom instance name. Setting EVERYTHING_URL selects an Everything HTTP service; credentials go in EVERYTHING_USERNAME and EVERYTHING_PASSWORD when needed.

All environment variables
VariableDefaultDescription
EVERYTHING_INSTANCEauto-detectProbes the default instance, 1.5a, and 1.5. Set this for a custom instance; "" selects the default instance.
EVERYTHING_URL""Everything HTTP server URL (e.g. http://127.0.0.1:17603/). When set, uses HTTP transport instead of IPC.
EVERYTHING_USERNAME""Basic auth username for HTTP server.
EVERYTHING_PASSWORD""Basic auth password for HTTP server.
EVERYTHING_MAX_RESULTS1000Row cap for each query and the whole batch (1–1000).
EVERYTHING_OUTPUT_BYTES16384Maximum output size budget per tool call (4096–65536).
EVERYTHING_TIMEOUT_MS15000Query timeout in milliseconds (100–120000).
EVERYTHING_ES_PATHbundledCustom path to es.exe.

CLI & Diagnostics

Test your Everything installation and backend connection:

powershell
npx -y everything-mcp-server doctor

Run queries from the command line:

powershell
npx -y everything-mcp-server search '{"requests": [{"query": "ext:pdf", "count": 5}]}'

Tool reference

Parameters and result format

search

Search, browse directories, count items, and retrieve indexed metadata.

Pass 1–8 queries in the required requests array:

json
{"requests": [{"query": "ext:pdf", "count": 5}]}

Parameters for each query:

ParameterTypeDefaultDescription
querystring""Everything search query (e.g. *.pdf, size:>100mb, ext:ts;js).
rootstringoptionalDirectory to search within (e.g. D:/Projects). Omitted for global search.
recursivebooleantrueWhen root is set: true searches descendants; false lists direct children.
kindstring"any"Filter entry type: "any", "file", or "folder".
regexbooleanfalseTreat query as a regular expression.
countnumber20Maximum rows to return (max 1000). Use 0 to count matches; add kind:"file" and fields:["size"] to get total_size_bytes.
offsetnumber0Zero-based pagination offset.
sortstring"path"Sort field: path, name, size, extension, date_modified, date_created, date_accessed, attributes, run_count.
ascendingbooleantrueSort ascending (true) or descending (false).
fieldsstring[][]Additional columns: size, date_modified, date_created, date_accessed, attributes, run_count.

IPC provides all listed fields and sorts. HTTP sorts by name, path, size, or modified time; it provides size and modified-time fields, with other metadata depending on the service.

Output Format:

Results label columns once, followed by row arrays:

json
{  "results": [    {      "base": "D:/Projects",      "total": 42,      "next_offset": 2,      "columns": ["path", "type", "size_bytes"],      "rows": [        ["src/index.ts", "file", 1024],        ["package.json", "file", 512]      ],      "size_basis": "indexed_logical"    }  ]}

Combine base with relative paths in rows to obtain full file paths. File and folder sizes use logical byte counts from Everything's index.

status

Check backend connectivity, Everything version, selected instance, and index status.

Parameters:

  • verbose (boolean, default false): Include total indexed items and limits.

Local Development

powershell
git clone https://github.com/EcRal5t/everything-search-mcp.gitcd everything-search-mcpnpm installnpm test

To configure an MCP client with a local checkout:

json
{  "mcpServers": {    "everything": {      "command": "node",      "args": ["D:/path/to/everything-search-mcp/src/cli.js"]    }  }}

License

MIT. Bundled es.exe is also MIT licensed by voidtools. See THIRD_PARTY_NOTICES.md.

来源：README.md，提交 8292039

工具

2

everything_status

Check connection status, selected instance, version, and index readiness.

输入参数verbose

版本历史

1
  1. v0.1.0最新Oct 31, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分