everything-mcp

MCP (Model Context Protocol) server for Everything — the lightning-fast Windows file search engine.

Uses ffi-rs to call the Everything SDK natively and @modelcontextprotocol/sdk for the MCP server protocol.

Prerequisites

• Windows (the Everything SDK is Windows-only)

• Everything 1.5+ installed and running (download)

• Node.js 18+ and pnpm

Related MCP server: local-stdio-mcp

Installation

pnpm install
pnpm build

Usage

Running the MCP server

node dist/index.js

The server communicates via stdin/stdout (MCP stdio transport).

Configuring in Claude Desktop / VS Code Copilot

Add to your MCP client configuration:

{
  "mcpServers": {
    "everything": {
      "command": "node",
      "args": ["w:\\projects\\everything-mcp\\dist\\index.js"]
    }
  }
}

Environment Variables

Tools

everything_search

Search for files and folders using Everything search syntax.

Parameters:

• query (required) — Search query using Everything syntax

• maxResults — Max results (default: 50, max: 1000)

• offset — Zero-based offset for pagination

• matchCase — Case-sensitive search

• matchWholeWord — Match whole words only

• matchPath — Match against full path

• regex — Treat query as regex

Everything search syntax examples:

• *.txt — all .txt files

• foo bar — files containing both "foo" AND "bar"

• foo|bar — files containing "foo" OR "bar"

• ext:jpg size:>1mb — JPEGs larger than 1 MB

• folder:node_modules — folders named node_modules

• content:TODO — files containing "TODO" in their content

• datemodified:today — files modified today

• parent:C:\Projects — files under C:\Projects

everything_version

Get the version information of the running Everything instance.

everything_status

Check if Everything is running and its database is loaded.

everything_file_info

Get Windows file attributes and run count for a specific file path.

Parameters:

• path (required) — Full path to the file or folder

Architecture

src/
├── index.ts              # MCP server entry point (tools, request handlers)
├── everything-client.ts  # High-level Everything client wrapper
└── ffi-bindings.ts       # Low-level FFI bindings to Everything3_x64.dll

License

MIT