# Everything Search MCP Server

A Model Context Protocol (MCP) server that integrates [Everything Search](https://www.voidtools.com/) with Claude Code, providing lightning-fast file searching capabilities.

## Features

- **400x faster** than traditional file search methods (find, ls, Get-ChildItem)
- **Sub-second results** across entire drives
- **5 specialized search tools**:
  - `search_files` - Search by filename pattern
  - `search_recent` - Find recently modified files
  - `search_large` - Find largest files
  - `search_by_extension` - Search by file type (code, docs, media, etc.)
  - `search_in_path` - Search within specific directories
- **Help resources** - Access complete documentation via MCP resources

## Requirements

- Node.js (v18+)
- Everything Search desktop application running (download from [voidtools.com](https://www.voidtools.com/))
- es.exe (Everything CLI) at `D:\WORKSPACE\tools\common\es.exe`

## Installation

```bash
cd D:\WORKSPACE\tools-node\mcp-everything-search
npm install
npm run build
```

## Configuration

Add to `~/.claude.json`:

```json
{
  "mcpServers": {
    "everything-search": {
      "command": "node",
      "args": [
        "D:\\WORKSPACE\\tools-node\\mcp-everything-search\\build\\index.js"
      ],
      "env": {
        "ES_EXE_PATH": "D:\\WORKSPACE\\tools\\common\\es.exe"
      }
    }
  }
}
```

Add to `~/.claude/settings.json`:

```json
{
  "permissions": {
    "allow": [
      "mcp__everything-search"
    ]
  }
}
```

## Usage

Once configured, Claude Code can use the search tools automatically:

- "Find all JavaScript files modified in the last 24 hours"
- "Show me the 10 largest files in the workspace"
- "Search for all markdown files in D:\WORKSPACE"
- "Find all TypeScript files in the src directory"

## Performance

| Method | Time | vs Baseline |
|--------|------|-------------|
| Everything Search | 0.05s | **400x faster** |
| find command | 20s | Baseline |
| Glob tool | 5-10s | 2-4x faster |

## Tools

### search_files
Search by filename pattern with wildcards or regex.

### search_recent
Find files modified within the last N hours, sorted by modification date.

### search_large
Find the largest files, optionally with minimum size threshold.

### search_by_extension
Search by file type category (code, docs, media) or custom extensions.

### search_in_path
Search within a specific directory, with optional recursion.

## Development

```bash
# Watch mode
npm run watch

# Build
npm run build
```

## License

MIT