Skip to content

QuickerHub/everything-mcp

Repository files navigation

@quickerhub/everything-mcp

Fast cross-project file search for AI agents via voidtools Everything on Windows.

Uses the Everything SDK DLL (same approach as QuickerPc), not es.exe.

Published by QuickerHub.

Architecture

Cursor / Claude / VS Code
  → everything-mcp.exe (MCP stdio)
  → Everything64.dll (bundled SDK IPC client)
  → Everything.exe (user-installed tray client + index engine)

The bundled DLL is only an IPC client. Everything.exe must be installed and running to maintain the file index.

Prerequisites

  1. Windows x64
  2. .NET 8 Runtime
  3. Everything 1.4.x installed (stable). Tray client should be running.
  4. Node.js 18+ (only for npx launcher)

No es.exe / ES CLI required.

MCP config

Direct exe (recommended for local dev)

{
  "mcpServers": {
    "everything-search": {
      "command": "D:\\source\\repos\\quicker\\everything-mcp\\publish\\cli\\everything-mcp.exe",
      "args": []
    }
  }
}

Build first:

cd D:\source\repos\quicker\everything-mcp
.\build.ps1 -Publish

npm launcher

{
  "mcpServers": {
    "everything-search": {
      "command": "npx",
      "args": ["-y", "@quickerhub/everything-mcp"]
    }
  }
}

Override exe path:

{
  "env": {
    "EVERYTHING_MCP_EXE": "D:\\path\\to\\everything-mcp.exe"
  }
}

Tools

Tool Description
search Search files/folders via Everything index (returns JSON)
status Check bundled SDK DLL and Everything client state

search parameters

Parameter Description
query Everything query (ext:cs, wildcards, etc.)
max_results Default 100, max 1000
scope_path Limit to folder subtree
match_path Match full path
match_case Case-sensitive
match_whole_word Whole words only
regex Regex mode
sort_by name_asc, date_modified_desc, ...
auto_start Try starting Everything tray client (default true)

Example

{
  "query": "quicker-rpc",
  "scope_path": "D:\\source\\repos\\quicker",
  "max_results": 20
}

Development

.\build.ps1          # build only
.\build.ps1 -Publish # publish to publish/cli
.\publish\cli\everything-mcp.exe --smoke-test

Release

Latest: https://github.com/QuickerHub/everything-mcp/releases/latest

.\publish\Publish-GitHubRelease.ps1 -Version 0.2.0
gh release create v0.2.0 --title "v0.2.0" artifacts/*

npm (@quickerhub/everything-mcp)

Requires NPM_TOKEN repo secret (npm automation token with publish access to @quickerhub).

gh secret set NPM_TOKEN --repo QuickerHub/everything-mcp
gh workflow run publish.yml --repo QuickerHub/everything-mcp -f version=0.2.0

Creating a GitHub Release also triggers the npm publish workflow automatically.

Comparison with QuickerPc

QuickerPc everything-mcp
SDK DLL Everything64.dll bundled same
Everything.exe user-installed, required same
IPC P/Invoke P/Invoke
es.exe not used not used

Related

License

MIT. Everything SDK DLL is from voidtools (public SDK); not affiliated with voidtools.

About

MCP server for fast cross-project file search via voidtools Everything (Windows)

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors