everything
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
everything-mcp bundle
English | 简体中文
MCP server that lets AI agents search local Windows files directly: Windows 10+, no installation, reuses the index of an existing Everything when available and falls back to an invisible bundled instance when not. Built on top of everything-mcp.
everything-mcp bundle wraps the file-indexing power of Everything in standard MCP tools, so any MCP-capable client (Claude Code, Cursor, Codex, DSH, ...) can search local files by name, type, modification time and size without opening the Everything window.
Five tools are provided:
Tool | Purpose |
| Search by filename wildcard / regular expression |
| Search by file category (images, videos, documents, code, ...) |
| Find recently modified files |
| Report metadata for one file or directory |
| Count matching files and their total size |
Install as a DSH plugin
This repository is also a DeepSeek Harness bundle (package.json → dsh.bundle.patch). Installing it registers the everything MCP server automatically, with no YAML editing and no path setup.
Open Plugins → Add plugin in DSH.
Provide this package: a clone of this repository or an extracted release zip.
Enable the plugin. The five
mcp__everything__*tools become available.
The plugin reuses a prepared runtime when one exists: its own runtime\venv, a local ~\.dsh\mcp\everything-mcp-bundle, or the bundle at this package's root. If none has a runtime, it bootstraps one on first use with Python 3.10+ (py/python on PATH), installing the pinned mcp==2.3.0 and pydantic==2.14.1 in the background. Everything itself is detected (App Paths registry, %ProgramFiles%, %LOCALAPPDATA%\Programs), and the bundled copy remains the fallback when nothing answers.
Every path is optional; fill these only when detection cannot cover the machine (edit the plugin row's config in the profile's cordis.patch.yml):
Field | Default | Purpose |
|
| Pin an everything-mcp directory (a wrong path is reported, never silently ignored). |
|
| Pin |
|
| Pin your own |
|
| Python used by the first-use bootstrap. |
|
| Instance name for the bundled copy only. |
|
| Stop the bundled copy after this much idle time. |
|
| Start budget for the bundled copy. |
|
| Start the bundled copy when no running Everything answers. |
|
| Hard cap per search; |
Disable any older manual mcp-everything row before enabling the plugin: both register the server name everything, and DSH refuses a duplicate. Uninstalling the plugin never deletes your Everything index, the bundle directory, or Python.
The rest of this README documents the portable bundle and its environment variables; both forms share the same server code and binaries.
Related MCP server: agent-inventory
Features
Reuses your existing index — if Everything is already installed, its
Everything.dbis used as-is, started hidden on demand and closed after 600 seconds idle or when the MCP server exits. No second database is ever built for the agent.Nothing stays resident — no Everything GUI or tray item is installed (apart from the indexing service used by mode B); Everything is only started when a tool runs and goes away afterwards.
Leaves your setup untouched — only processes started by this bundle are stopped. An Everything you started yourself is never closed, and its index and service stay exactly as they were.
A choice at install time — when a local Everything is found, a dialog lets you reuse that installation, browse to a specific
everything.exe, or use the bundled copy.Bundled fallback — when no local Everything exists, the bundle uses its own invisible copy (instance name
everything-mcp, separate index; the first build takes a few minutes).Python is not bundled — setup detects an existing interpreter (>= 3.10) and only downloads the official build when none is found (python.org first, mirrors as fallback, SHA-256 verified).
One UAC prompt — mode B asks for administrator rights once to install the Everything service; indexing NTFS volumes needs no further elevation.
Offline-friendly —
bin\es.exeandruntime\everything\everything.exeare unmodified official binaries shipped with the bundle.Host configs generated for you —
hosts\receives ready-to-paste snippets for Claude Code, Cursor, Gemini CLI, Codex and DSH.
Changes relative to upstream everything-mcp
This release is based on upstream elis132/everything-mcp 1.0.9 (MIT).
Upstream provides a minimal implementation that queries Everything through es.exe and exposes the results as MCP tools. This release keeps that query core and adds portable distribution, process lifecycle management, failure recovery, and install/uninstall tooling. Module by module:
Module | Upstream 1.0.9 | Added / enhanced in this release |
Tool surface | Basic file search | Five structured tools (see the table above): type filtering, recent files, file details, count/size statistics; per-call result cap ( |
Process lifecycle | Expects Everything to be running; does not start or stop it | New |
Index reuse | Uses the currently running Everything instance | Reuses the existing local |
Run modes | Single "connect to a running instance" behaviour |
|
Installation | Manual configuration |
|
Reliability | Calls |
|
Configuration | A few environment variables | All 11 environment variables supported (table below); |
Diagnostics | None |
|
Packaging | Source only | Official |
Uninstall | None |
|
Modified upstream files
mcp\everything_mcp\server.py— tool definitions extended to five; startup/shutdown lifecycle hooks; instance liveness check before every tool call; additional logging and error messages.mcp\everything_mcp\backend.py— hardenedes.exequery path (argument and-timeoutinjection, single-flight/cross-process locks, daemon-thread I/O, cleanup of hung processes, result truncation and formatting).mcp\everything_mcp\config.py— newEVERYTHING_USER_EXE,EVERYTHING_DISABLE_USER_INSTALL,EVERYTHING_AUTOSTART,EVERYTHING_MCP_INSTANCEand related settings; defaults and detection order.mcp\everything_mcp\__init__.py,__main__.py— package entry points and version.supervisor.py,setup.ps1,uninstall.ps1,run-mcp.cmd,hosts\,manifest.json— new in this project (no upstream counterpart).
Compatibility notes
Tool names and arguments are those in the "Five tools" table above; when migrating from upstream, regenerate the host config (
hosts\ordsh-snippet.yml).Everything query syntax (wildcards, regular expressions,
ext:,path:,size:,dm:, etc.) is still executed byes.exeunchanged.Behavioural difference: upstream expects the host to keep Everything running and never closes it. This release starts Everything hidden by default and closes only the instances it started, after 600 seconds idle or when the MCP server exits. Set
EVERYTHING_AUTOSTART=0, or choose mode A/C during setup, to get the "connect only, never start" behaviour.Licensing is unchanged: this release and upstream are both MIT. The upstream copyright notice is kept in
LICENSE-everything-mcp.txt; modifications and additions are released under the same MIT terms. Third-party components are listed inTHIRD-PARTY-NOTICES.md.
Quick start
git clone https://github.com/<your-account>/everything-mcp-bundle.git
cd everything-mcp-bundle
powershell -ExecutionPolicy Bypass -File .\setup.ps1The installer asks for a run mode (default B) and then:
detects or downloads Python;
creates
runtime\venvand installs the pinned dependencies (mcp==2.3.0,pydantic==2.14.1);in mode B, looks for a local Everything: if one is found, a dialog asks how to reuse it (existing index, no prewarm); only when none is found does it use the bundled copy, request one UAC prompt to install the indexing service, and prewarm the bundled index (a few minutes the first time);
writes host config snippets to
hosts\.
Merge the matching snippet into your host configuration and restart the host. You can also skip the snippets and let the host run:
command: C:\Windows\System32\cmd.exe
args: ["/c", "<bundle>\run-mcp.cmd"]The host must be restarted after every bundle update (or MCP configuration change) so that it launches the new server process. The first search after startup waits for Everything to load the existing index (about 5–15 seconds for 139 MB); every search after that takes milliseconds.
Run modes
Mode | Behaviour | Good for |
| Connects only to an already running Everything; never starts an instance | Machines that keep Everything running |
| Prefers the local Everything (started hidden when needed, closed on idle/exit); falls back to the bundled copy when neither is available | Most setups, works out of the box |
| Connects only; fails with an error instead of falling back | Locked-down or security-sensitive machines |
powershell -ExecutionPolicy Bypass -File .\setup.ps1 -Mode AHow it works
MCP host (Claude / Cursor / Codex / DSH ...)
│ stdio JSON-RPC
▼
run-mcp.cmd → runtime\venv\python.exe -m everything_mcp
│
├─ es.exe ──IPC──▶ a running Everything (default or named instance)
│
└─ supervisor.py, in order, when no instance is running
1. reuse the local everything.exe (hidden start, -startup)
2. no local installation → start the bundled runtime\everything\everything.exe
(instance name everything-mcp, separate index)
3. poll IPC until ready (60 s timeout by default)
4. on idle timeout or MCP server exit, close the instances "it started" with es -exitWhen a local installation is reused, its existing
Everything.dbis used as-is — no copy, no rebuild.Portable Everything installs (not in the registry or the usual directories) are found with a depth-limited fixed-drive scan;
EVERYTHING_NO_DRIVE_SCAN=1disables it.Before starting a local Everything, its storage must be writable (portable = the exe directory, installed =
%APPDATA%\Everything); if it is not, the bundle skips it instead of triggering the "cannot save settings" dialog.The bundled copy uses instance name
everything-mcpand keeps its portable settings and index underruntime\everything\.Cross-process heartbeat + owner files: self-started instances left behind by a crashed MCP server are handled on the next start under the "only clean up processes we started" rule.
Every path can be overridden with environment variables (table below).
Bundle layout
everything-mcp-bundle\
├─ bin\es.exe voidtools ES CLI (official binary)
├─ runtime\everything\ invisible bundled Everything fallback
│ ├─ everything.exe Everything 1.4.1.1026 (MIT)
│ ├─ Everything.ini portable settings (instance everything-mcp)
│ └─ License-Everything.txt
├─ mcp\everything_mcp\ MCP server source (including supervisor.py)
├─ setup.ps1 installer
├─ uninstall.ps1 uninstaller
├─ run-mcp.cmd generic launcher
├─ hosts\ host config snippets generated at install time
├─ src\es-cli.c ES source (from the official zip, for auditing)
├─ vendor\ES-1.1.0.27.zip official ES archive
├─ manifest.json component list with SHA-256 hashes
├─ LICENSE / THIRD-PARTY-NOTICES.md / CHANGELOG.mdSetup parameters
-Mode A|B|C run mode (interactive prompt when omitted; default B)
-UserEverythingExe <path> reuse this everything.exe (skips the selection dialog)
-UseBundledEverything use the bundled copy without asking
-NoEverythingDialog no selection dialog; use console prompts instead
-PythonExe <path> use this interpreter; skip detection/download
-PythonVersion 3.13.17 version to download when no interpreter is found
-InstallForm portable|installer portable = official zip extracted into runtime\python (default)
-NoPrewarm skip index prewarming when falling back to the bundled copy
-DryRun print the plan only; do not change anything
-Force recreate the venvDownload and verification order:
Python:
python.org→ Huawei Cloud mirror → TUNA mirror; SHA-256 comes from the officialwindows-<version>.json.pip dependencies: PyPI → TUNA → Aliyun.
Host configuration
hosts\ receives these snippets after installation:
File | Host |
| Claude Desktop / Claude Code |
| Cursor |
| Gemini CLI |
| Codex |
| DSH (append to the profile's |
Example (JSON, reusing a local Everything):
{
"mcpServers": {
"everything": {
"command": "C:\\path\\to\\everything-mcp-bundle\\runtime\\venv\\Scripts\\python.exe",
"args": ["-m", "everything_mcp"],
"env": {
"PYTHONPATH": "C:\\path\\to\\everything-mcp-bundle\\mcp",
"EVERYTHING_ES_PATH": "C:\\path\\to\\everything-mcp-bundle\\bin\\es.exe",
"EVERYTHING_USER_EXE": "D:\\path\\to\\user\\Everything\\everything.exe",
"EVERYTHING_AUTOSTART": "1",
"EVERYTHING_IDLE_TIMEOUT": "600"
}
}
}
}When falling back to the bundled copy, replace EVERYTHING_USER_EXE with:
"EVERYTHING_EXE": "C:\\path\\to\\everything-mcp-bundle\\runtime\\everything\\everything.exe",
"EVERYTHING_MCP_INSTANCE": "everything-mcp",
"EVERYTHING_DISABLE_USER_INSTALL": "1"Environment variables
Variable | Default | Description |
| bundled | Path to es.exe |
| empty | Reuse this |
| empty |
|
| empty |
|
| bundled | Path to the bundled copy |
|
| Instance name of the bundled copy |
|
|
|
|
| Seconds of idleness before closing an instance this bundle started; |
|
| Seconds to wait for IPC readiness |
| empty | Connect only to this named instance; no instance will be started |
|
| Maximum number of results per search |
Verification and troubleshooting
# current state: detected local install / running instances / whether this process started them
runtime\venv\Scripts\python.exe -m everything_mcp.supervisor --status
# connect or start and wait until the index is usable (builds the index for the bundled fallback)
runtime\venv\Scripts\python.exe -m everything_mcp.supervisor --prewarm --timeout 900
# stop the instances this process started
runtime\venv\Scripts\python.exe -m everything_mcp.supervisor --stop
# test IPC directly (do not pass -instance when reusing a local installation)
bin\es.exe -get-everything-versionSymptom | What to do |
Tools unavailable right after a bundle update or MCP config change | Restart the host so it relaunches the MCP server (the old process still runs the old code) |
| Everything may lose one IPC reply while it is starting and still loading its index; wait a few seconds and retry — the server recovers automatically. If it persists, restart the host |
| No Everything is running and none could be started. Check that |
Zero results / the first call is very slow | There is no reusable index and the bundled copy is still building its own; confirm with |
Reuse one specific installation | Pass |
Do not reuse the local Everything | Choose "use the bundled copy" during setup, pass |
A "cannot save settings" dialog appears | The local Everything's storage is not writable (portable = the exe directory, installed = |
UAC was cancelled | The service was not installed; rerun |
Antivirus false positive |
|
The server logs to stderr (as required by the MCP stdio transport).
Uninstall
powershell -ExecutionPolicy Bypass -File .\uninstall.ps1By default it removes: processes of the bundled copy, the Everything service installed by this setup (only when the service binary points into the bundle; an existing service of yours is left alone), the bundled index, runtime\venv / site-packages, downloaded Python, the generated config snippets and host-config.json.
Always kept: your own Everything program, its index, and any Everything service you installed or configured yourself — the uninstaller neither stops them nor deletes their data.
Keep options: -KeepVenv, -KeepPython, -KeepIndex; -RemoveBundle also deletes es.exe, everything.exe and the MCP source.
Development notes
MCP source lives in
mcp\everything_mcp\:server.py(tool definitions),config.py(connection detection),supervisor.py(lifecycle).Lifecycle order: explicit instance → already running instance → local installation (hidden
-startup) → bundled copy; only instances started here are stopped or cleaned up.setup.ps1/uninstall.ps1support Windows PowerShell 5.1 and PowerShell 7.After changing the source, refresh
file_hashesinmanifest.json; record releases inCHANGELOG.md.Known limits: Windows 10+ only; stdio transport only; Everything's HTTP/ETP server is never enabled.
License
Project code: MIT
Third-party components (Everything, ES, upstream everything-mcp): THIRD-PARTY-NOTICES.md
Bundled Everything / ES binaries are unmodified official builds (MIT, Copyright © David Carpenter)
Acknowledgements
voidtools Everything — file indexing and IPC
elis132/everything-mcp — the original MCP server implementation
Dependencies:
mcp==2.3.0,pydantic==2.14.1(fetched from PyPI at install time, not redistributed)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Securely search and manage workspace context files for AI agents and teams.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Search and fetch AI agent skills, rules files and MCP servers indexed from GitHub.
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search local files on Windows using the Everything search engine, supporting basic and complex file searches with filters like date, size, media type, and document type.4MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search and inspect a Windows machine's local inventory of agents, skills, MCP servers, projects, and cross-agent work records, with tools for full-text search, overviews, project details, and reindexing. All data stays local and only matching snippets enter model context.83MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search whole NTFS volumes by filename without any background GUI, parsing the $MFT directly and refreshing results from the USN Journal on demand. Supports an Everything-compatible query subset (boolean, path:, ext:, size:, date and regex filters), plus index status and full rebuild tools.MIT
- AlicenseNot gradedqualityBmaintenanceExposes the local voidtools Everything index over MCP stdio on Windows, letting AI agents search, filter, aggregate, detect duplicates and grep file contents across millions of index entries in milliseconds instead of recursively scanning disks. It provides 13 tools and 3 resources, running loopback-only and read-only by default.MIT