Everything MCP Server

An MCP server for Everything by VoidTools that provides Claude Desktop with lightning-fast filesystem search on Windows. This implementation uses native C bindings via the Everything SDK for maximum performance, with a transparent fallback to the HTTP API.

Features

• Blazing Fast: Leverages the native Everything64.dll for near-instant results.
• Architecture Aware: Automatically detects and loads the correct DLL (32-bit or 64-bit) based on your Node.js runtime.
• Thread Safe: Implements an internal Mutex to prevent race conditions during concurrent tool calls.
• Non-Blocking: Uses asynchronous worker threads for SDK queries to keep the MCP connection responsive.
• Smart Fallback: Automatically switches to the Everything HTTP Server if the SDK is unavailable.

Prerequisites

• Windows OS: Required for native SDK functionality.
• Everything Search: Must be installed and running.
• Everything SDK: Download here. Ensure the DLLs are in your system PATH or configured via environment variables.
• Node.js: Version 18 or higher.

Installation

1. Clone and Install:

npm install

2. Build the Project:

npm run build

3. Configure Claude Desktop: Add the following to your %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "everything": {
      "command": "node",
      "args": ["C:\\path\\to\\everything-mcp\\dist\\index.js"],
      "env": {
        "EVERYTHING_SDK_PATH": "C:\\path\\to\\Everything64.dll"
      }
    }
  }
}

Tool: search_files

Search for files and folders across your entire system with advanced filtering.

Parameters

Parameter	Type	Default	Description
query	string	(required)	Search terms (supports Everything search syntax).
count	number	100	Maximum number of results to return (1–1000).
offset	number	0	Pagination offset for large result sets.
sort	string	"name"	name, path, size, date_created, date_modified, extension.
ascending	boolean	true	Set to false for descending order.
path	string	-	Scope search to a specific directory.
regex	boolean	false	Enable regular expression matching.
case	boolean	false	Enable case-sensitive matching.

Development & Testing

The project includes a robust test suite to simulate MCP JSON-RPC communication:

# Run the universal test script
node test-mcp.js