Everything-MCP

Overview

Everything-MCP is a project that integrates Everything (Voidtools), an ultra-fast file search engine for Windows, as an MCP (Model Context Protocol) server. This enables natural language file search on local systems through MCP clients like Claude Desktop, OpenAI ChatGPT, and others.

Built with Node.js/TypeScript, it can be easily installed and run via npm without requiring a separate Python installation.

Features

| Feature | Description | |---------|-------------| | everything_search(query) | Ultra-fast file/folder search via Everything CLI (es.exe) | | everything_open(path) | Open searched files/folders with default application (Windows only) | | everything_glob(folder, pattern) | Perform folder-based wildcard search | | quick_index_prompt(topic) | Generate summary prompts from search results |

Prerequisites

1. Node.js Installation (v18 or higher)

   • https://nodejs.org/

2. Everything Installation

   • https://www.voidtools.com/

3. Everything CLI (es.exe) Installation

   • https://www.voidtools.com/support/everything/command_line_interface/

   • Add es.exe to PATH or specify the absolute path in the ES_PATH variable in src/index.ts

   • Enable Everything Service and build the initial index

Quick Start

Using npx (Recommended - No installation required)

npx everything-mcp

This will download and run the latest version automatically. Register it in your MCP client (see setup instructions below).

Local Development

# 1. Clone the repository
git clone https://github.com/chahero/everything-mcp.git
cd everything-mcp

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Run the server
npm start

Or in development mode:

npm run dev

Setting Up with Claude Desktop

Method 1: Using npx (Recommended)

1. Open Claude Desktop Configuration File

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following configuration:

   {
     "mcpServers": {
       "everything-mcp": {
         "command": "npx",
         "args": ["everything-mcp"]
       }
     }
   }

3. Restart Claude Desktop

   • Save the configuration file and completely restart Claude Desktop.

4. Verify Connection

   • Start a new conversation in Claude Desktop. You should see the "everything-mcp" server connected at the bottom left.

Method 2: Using Local Path (If you cloned the repository)

1. Open Claude Desktop Configuration File

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following configuration:

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

   Replace C:\\path\\to\\everything-mcp with the actual path to your cloned repository.

3. Restart Claude Desktop

   • Save the configuration file and completely restart Claude Desktop.

4. Verify Connection

   • Start a new conversation in Claude Desktop. You should see the "everything-mcp" server connected at the bottom left.

Extension Ideas

• Enable Everything HTTP Server for REST API integration
• Combine with Naver API, Gemini API, OpenAI API to build hybrid search MCP
• Integrate with RAG (Retrieval-Augmented Generation) search pipelines

Project Structure

everything-mcp/
 ├── src/
 │   └── index.ts                # MCP server main code (TypeScript)
 ├── dist/                       # Compiled JavaScript (generated after build)
 ├── package.json                # npm package configuration
 ├── tsconfig.json               # TypeScript configuration
 ├── README.md                   # Project documentation
 └── .gitignore                  # Git ignore rules

Limitations

• Windows only (limited to Everything supported OS)
• es.exe must have admin privileges to access admin-indexed paths
• Full functionality guaranteed only in UTF-8 encoding environment

Development Information

• Runtime: Node.js 18+
• Language: TypeScript 5.0+
• MCP SDK: @modelcontextprotocol/sdk
• Everything CLI Docs: https://www.voidtools.com/support/everything/command_line_interface/

License

MIT License — Free to modify and distribute.