Everything Search MCP

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.)

OpenAI Codex

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

[mcp_servers.everything]

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

Or add via Codex CLI:

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

OpenCode

Add to your project's opencode.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:

opencode mcp add

DeepSeek Harness

Install the plugin, then restart the profile:

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

Or install straight from this repository:

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:

- 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):

{

"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.

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

CLI & Diagnostics

Test your Everything installation and backend connection:

npx -y everything-mcp-server doctor

Run queries from the command line:

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:

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

Parameters for each query:

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:

{

"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

git clone https://github.com/EcRal5t/everything-search-mcp.git

cd everything-search-mcp npm install npm test

To configure an MCP client with a local checkout:

{

"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.