Everything Search MCP Server

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

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

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

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.

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.

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

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.