Everything Search MCP

Name: Everything Search MCP
Author: EcRal5t

Local

github.com/EcRal5tSearch0Updated 2w ago

Repository

About Everything Search MCP

Everything Search MCP connects an AI assistant to Everything’s indexed Windows file search. It is for people who need to locate and inspect files, with filters for names, paths, types, sizes, and dates, plus folder browsing and size summaries.

Key features

01Search by name, path, and metadata
02Browse folders with paginated results
03Count matches and total file sizes
04Compare folder sizes
05Check Everything connection and version

Use cases

01Find PDFs modified within a date range
02Locate large logs or archives
03Count selected folders in a project tree
04Compare sizes of folders

MCP support

As an MCP server, it exposes read-only `search` and `status` tools to clients for querying the Everything index and checking connection status.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "ecral5t-everything-search": {
      "command": "npx",
      "args": [
        "-y",
        "everything-mcp-server"
      ]
    }
  }
}

Run commandnpx -y everything-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmeverything-mcp-server0.1.0stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
requests	array	Yes	1–8 queries, in result order.

Details

From the project 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.)

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.

Tool	Purpose
`search`	Find paths, browse folders, count matches, and retrieve sizes or other indexed metadata.
`status`	Check 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

Variable	Default	Description
`EVERYTHING_INSTANCE`	auto-detect	Probes 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_RESULTS`	`1000`	Row cap for each query and the whole batch (1–1000).
`EVERYTHING_OUTPUT_BYTES`	`16384`	Maximum output size budget per tool call (4096–65536).
`EVERYTHING_TIMEOUT_MS`	`15000`	Query timeout in milliseconds (100–120000).
`EVERYTHING_ES_PATH`	bundled	Custom path to `es.exe`.

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:

Parameter	Type	Default	Description
`query`	string	`""`	Everything search query (e.g. `*.pdf`, `size:>100mb`, `ext:ts;js`).
`root`	string	optional	Directory to search within (e.g. `D:/Projects`). Omitted for global search.
`recursive`	boolean	`true`	When `root` is set: `true` searches descendants; `false` lists direct children.
`kind`	string	`"any"`	Filter entry type: `"any"`, `"file"`, or `"folder"`.
`regex`	boolean	`false`	Treat `query` as a regular expression.
`count`	number	`20`	Maximum rows to return (max 1000). Use `0` to count matches; add `kind:"file"` and `fields:["size"]` to get `total_size_bytes`.
`offset`	number	`0`	Zero-based pagination offset.
`sort`	string	`"path"`	Sort field: `path`, `name`, `size`, `extension`, `date_modified`, `date_created`, `date_accessed`, `attributes`, `run_count`.
`ascending`	boolean	`true`	Sort ascending (`true`) or descending (`false`).
`fields`	string[]	`[]`	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:

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.

Everything Search MCP

About Everything Search MCP

Key features

Use cases

MCP support

Configuration

Tools

Details

Everything Search MCP

Prerequisites

Installation & Configuration

What to ask

Tools

Connection settings

CLI & Diagnostics

Tool reference

search

status

Local Development

License

Comments

New to MCP?

What is MCP (Model Context Protocol)?

How do MCP servers differ from clients?

Should I use a local or a remote server?

How do I install a server in Claude, Cursor and others?

Are listed projects reviewed? What does “Verified” mean?

My project is listed. How do I claim it?

`search`

`status`