{"_id":"@danielsimonjr/everything-mcp","_rev":"7-09914a076ea5cacb294c9e12d024ab1c","name":"@danielsimonjr/everything-mcp","dist-tags":{"latest":"3.2.0"},"versions":{"1.0.0":{"name":"@danielsimonjr/everything-mcp","version":"1.0.0","keywords":["mcp","everything","search","file-search","windows","es.exe","voidtools"],"author":{"url":"https://github.com/danielsimonjr","name":"Daniel Simon Jr."},"license":"MIT","_id":"@danielsimonjr/everything-mcp@1.0.0","maintainers":[{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"}],"homepage":"https://github.com/danielsimonjr/everything-mcp","bugs":{"url":"https://github.com/danielsimonjr/everything-mcp/issues"},"bin":{"everything-mcp":"index.js"},"dist":{"shasum":"ed9df2dab3650de939e2e2ff20228f05d4fa9af1","tarball":"https://registry.npmjs.org/@danielsimonjr/everything-mcp/-/everything-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-l+jQxazXBb7itPS64cmXjzVqej7FpfWiuyMqUkE1i5gRv7VDPy1p/o0rCILxTsO/joEU7fZfyJXeuPPVCjHW5w==","signatures":[{"sig":"MEYCIQD3ktaBwS0O0WJE3VdHNXHF06FRZxSUHTwTvmrk13DWlwIhAJELn+0MpATB8Omq35Aic9822XQ3/lQiI0oF5UIwjojJ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17634},"main":"index.js","type":"commonjs","gitHead":"6980a7916c513c70924b509828060af108b1c6dd","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"},"repository":{"url":"git+https://github.com/danielsimonjr/everything-mcp.git","type":"git"},"_npmVersion":"11.4.2","description":"MCP server for Everything search engine - blazing fast file search for Windows","directories":{},"_nodeVersion":"25.1.0","dependencies":{"@modelcontextprotocol/sdk":"^1.20.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/everything-mcp_1.0.0_1762915663862_0.4607503998488329","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@danielsimonjr/everything-mcp","version":"1.0.1","keywords":["mcp","everything","search","file-search","windows","es.exe","voidtools"],"author":{"url":"https://github.com/danielsimonjr","name":"Daniel Simon Jr."},"license":"MIT","_id":"@danielsimonjr/everything-mcp@1.0.1","maintainers":[{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"}],"homepage":"https://github.com/danielsimonjr/everything-mcp","bugs":{"url":"https://github.com/danielsimonjr/everything-mcp/issues"},"bin":{"everything-mcp":"index.js"},"dist":{"shasum":"d9283deeea085df2466ddde500e7249d32327ee0","tarball":"https://registry.npmjs.org/@danielsimonjr/everything-mcp/-/everything-mcp-1.0.1.tgz","fileCount":4,"integrity":"sha512-zYPYp7rFs/iM9P3SJblJwjFY1RXIUwrpTtcQ5kN1Shtk7AuVQsIp49FRfHJvOM7inYC9vDd1eAhlsB0Kp/skdQ==","signatures":[{"sig":"MEQCIADIi8BhAqRnKn2FLxMIISHAqu6pnwoS6nCnJO/pRiIoAiBtPmMm3sThrD6SOz0Bg82tvartCqmf5DV831VDok699Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17534},"main":"index.js","type":"commonjs","gitHead":"e61da7db7e49973b46ec208927f5517bc0f352b4","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"},"repository":{"url":"git+https://github.com/danielsimonjr/everything-mcp.git","type":"git"},"_npmVersion":"11.6.4","description":"MCP server for Everything search engine - blazing fast file search for Windows","directories":{},"_nodeVersion":"25.2.1","dependencies":{"@modelcontextprotocol/sdk":"^1.20.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/everything-mcp_1.0.1_1765341477687_0.9333263004508223","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@danielsimonjr/everything-mcp","version":"1.2.0","keywords":["mcp","everything","search","file-search","windows","es.exe","voidtools"],"author":{"url":"https://github.com/danielsimonjr","name":"Daniel Simon Jr."},"license":"MIT","_id":"@danielsimonjr/everything-mcp@1.2.0","maintainers":[{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"}],"homepage":"https://github.com/danielsimonjr/everything-mcp","bugs":{"url":"https://github.com/danielsimonjr/everything-mcp/issues"},"bin":{"everything-mcp":"index.js"},"dist":{"shasum":"538c865318c16c0b295bb86e1853e8c45ff7329c","tarball":"https://registry.npmjs.org/@danielsimonjr/everything-mcp/-/everything-mcp-1.2.0.tgz","fileCount":4,"integrity":"sha512-xFUjVJUUTMlXQKmlYcpO4meeiHxuBBbGer75JEOsRyY6yxcbfeZuZsJvBC5rt4IFPivw8KUP5UuNKVDk1cyjAA==","signatures":[{"sig":"MEUCIQCy+ViqWhd67WU3cY5GzDqH2+U84MHlcNuo2ThmrjE+OQIgNnX75KifZbEFu1O9wsrHVHKd9yTP3DhsrIifjq0ljRw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19844},"main":"index.js","type":"commonjs","gitHead":"cd82e56c7bb03a8370e075207f9b89ee4a40fe9e","scripts":{},"_npmUser":{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"},"overrides":{"@hono/node-server":"^2.0.5"},"repository":{"url":"git+https://github.com/danielsimonjr/everything-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Everything search engine - blazing fast file search for Windows","directories":{},"_nodeVersion":"24.19.0","dependencies":{"@modelcontextprotocol/sdk":"^1.20.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/everything-mcp_1.2.0_1786595068018_0.5071251956915503","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@danielsimonjr/everything-mcp","version":"2.0.0","keywords":["mcp","everything","search","file-search","windows","es.exe","voidtools"],"author":{"url":"https://github.com/danielsimonjr","name":"Daniel Simon Jr."},"license":"MIT","_id":"@danielsimonjr/everything-mcp@2.0.0","maintainers":[{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"}],"homepage":"https://github.com/danielsimonjr/everything-mcp","bugs":{"url":"https://github.com/danielsimonjr/everything-mcp/issues"},"bin":{"everything-mcp":"index.js"},"dist":{"shasum":"a01121f20153f7e981e6b3d0534518d10aa9c24d","tarball":"https://registry.npmjs.org/@danielsimonjr/everything-mcp/-/everything-mcp-2.0.0.tgz","fileCount":4,"integrity":"sha512-FWaue0S1dd8xtUmk9I1OC5EMYfrau9fIb5tA3oGFiHmty8+DUPihfExda6y3A0rmbXdmCqTievzbPxan7QT6+g==","signatures":[{"sig":"MEYCIQCkvUt5DskW+VNMLJAFEBv7A1hlQv1/x86fHkHHm+OQ8gIhALZCwJn6vlZytqPJ05ug+Y+LkCscXJ7d3QYOTdZ22aZ4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20015},"main":"index.js","type":"commonjs","gitHead":"c6183845b6cf01c87b40861c0b1707c709a98144","scripts":{},"_npmUser":{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"},"overrides":{"@hono/node-server":"^2.0.5"},"repository":{"url":"git+https://github.com/danielsimonjr/everything-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Everything search engine - blazing fast file search for Windows","directories":{},"_nodeVersion":"24.19.0","dependencies":{"@modelcontextprotocol/core":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/everything-mcp_2.0.0_1788623566956_0.23424335868440482","host":"s3://npm-registry-packages-npm-production"}},"3.0.0":{"name":"@danielsimonjr/everything-mcp","version":"3.0.0","keywords":["mcp","everything","search","file-search","windows","es.exe","voidtools","bun"],"author":{"url":"https://github.com/danielsimonjr","name":"Daniel Simon Jr."},"license":"MIT","_id":"@danielsimonjr/everything-mcp@3.0.0","maintainers":[{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"}],"homepage":"https://github.com/danielsimonjr/everything-mcp","bugs":{"url":"https://github.com/danielsimonjr/everything-mcp/issues"},"bin":{"everything-mcp":"src/index.ts"},"dist":{"shasum":"c26e321a337d904be243996a843804abd3245530","tarball":"https://registry.npmjs.org/@danielsimonjr/everything-mcp/-/everything-mcp-3.0.0.tgz","fileCount":7,"integrity":"sha512-wSQFNUv4DVH+NZP73rNyTa6Ihw788YLo6tp3u/qr1sj5s7WPujF0ABsQSDf7EW973AsdFzs2Ejp5sUk8XHMgHA==","signatures":[{"sig":"MEQCIDTvPRRHGEh65st+ZuSbgE3H3BI+r2gB9E2dxh8PTHGyAiAOWkkMjI5a/AsNwntV+E9CLlZRw1HexNNWcbiWKghTqA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":415842},"main":"./src/index.ts","type":"module","module":"./src/index.ts","engines":{"bun":">=1.1.0"},"gitHead":"99fe4a22eb65eb89f453c1e24808732e96283739","scripts":{"test":"bun test","build":"bun build ./src/index.ts --outfile=bundle/index.js --target=node --format=esm --minify","smoke":"bun run scripts/stdio-smoke.ts","start":"bun run src/index.ts","typecheck":"tsc --noEmit","prepublishOnly":"bun run typecheck && bun run build && bun run smoke"},"_npmUser":{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"},"repository":{"url":"git+https://github.com/danielsimonjr/everything-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Everything search engine - blazing fast file search for Windows","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.2.0","@modelcontextprotocol/core":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.2","devDependencies":{"@types/bun":"^1.2.0","typescript":"^5.9.0"},"_npmOperationalInternal":{"tmp":"tmp/everything-mcp_3.0.0_1788724086728_0.35716521501451526","host":"s3://npm-registry-packages-npm-production"}},"3.1.0":{"name":"@danielsimonjr/everything-mcp","version":"3.1.0","keywords":["mcp","everything","search","file-search","windows","es.exe","voidtools","bun"],"author":{"url":"https://github.com/danielsimonjr","name":"Daniel Simon Jr."},"license":"MIT","_id":"@danielsimonjr/everything-mcp@3.1.0","maintainers":[{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"}],"homepage":"https://github.com/danielsimonjr/everything-mcp","bugs":{"url":"https://github.com/danielsimonjr/everything-mcp/issues"},"bin":{"everything-mcp":"src/index.ts"},"dist":{"shasum":"4e5409748c0ecf6b779f132ee4479eedf3165cc5","tarball":"https://registry.npmjs.org/@danielsimonjr/everything-mcp/-/everything-mcp-3.1.0.tgz","fileCount":7,"integrity":"sha512-gaHI48VUwIySj4W7S7IC/S9W3WBwDMe/tGNTX6T8aAxaa0VwEKDYUbQsR/s/SRd5oAQY4/m2ywRk5G5owHeoTw==","signatures":[{"sig":"MEYCIQDCh3Uyx921awSBzI9dL06PQKeiDG2/RTRTUtRTQXRIIQIhAIU8APJ5koZ0/MSujA43vs2LFKwK/StvLkx0TuS9Nmwn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":419746},"main":"./src/index.ts","type":"module","module":"./src/index.ts","engines":{"bun":">=1.1.0"},"gitHead":"784d84cf97fc84a1a5bc4e280d20b123a0cc41db","scripts":{"test":"bun test","build":"bun build ./src/index.ts --outfile=bundle/index.js --target=node --format=esm --minify","smoke":"bun run scripts/stdio-smoke.ts","start":"bun run src/index.ts","typecheck":"tsc --noEmit","prepublishOnly":"bun run typecheck && bun run build && bun run smoke"},"_npmUser":{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"},"repository":{"url":"git+https://github.com/danielsimonjr/everything-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Everything search engine - blazing fast file search for Windows","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.2.0","@modelcontextprotocol/core":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.2","devDependencies":{"@types/bun":"^1.2.0","typescript":"^5.9.0"},"_npmOperationalInternal":{"tmp":"tmp/everything-mcp_3.1.0_1788733387237_0.027260572130759053","host":"s3://npm-registry-packages-npm-production"}},"3.2.0":{"_id":"@danielsimonjr/everything-mcp@3.2.0","bin":{"everything-mcp":"src/index.ts"},"bugs":{"url":"https://github.com/danielsimonjr/everything-mcp/issues"},"dist":{"shasum":"98884a137a8ada1e1bfc3a6e4fd87790a51368ab","tarball":"https://registry.npmjs.org/@danielsimonjr/everything-mcp/-/everything-mcp-3.2.0.tgz","fileCount":7,"integrity":"sha512-+FKSIx3J8inge6tAZGai3ukXcbrPQVZgzaDs8jZE2E7Wram6KvXhIxnthjsQXyz/r2kItyNnkmKXWHGWdWWaXA==","signatures":[{"sig":"MEUCIGVmqYY/8+VVrK8acexEdWeUI3bUOmBosctpz7D2SLd/AiEAoa7bxR8bk9TAIOUZPsbcdn2o1fydWV66nyQIUJzmAlg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCj7gR00gQW6hWREco7pvlAHbGg82HlbMJF8ZxJErnvIwIgKQuNrJ6HHElrTYheCvjl/rxrlxG+aWkPf8s1/f80Ba8="}],"unpackedSize":412832},"main":"./src/index.ts","name":"@danielsimonjr/everything-mcp","type":"module","author":{"url":"https://github.com/danielsimonjr","name":"Daniel Simon Jr."},"module":"./src/index.ts","engines":{"bun":">=1.1.0"},"gitHead":"ab9363b69ca6bf808a91ba2593279fa993c75a12","license":"MIT","scripts":{"test":"bun test","build":"bun build ./src/index.ts --outfile=plugin/bundle/index.js --target=node --format=esm --minify","smoke":"bun run scripts/stdio-smoke.ts","start":"bun run src/index.ts","typecheck":"tsc --noEmit","prepublishOnly":"bun run typecheck && bun run build && bun run smoke"},"version":"3.2.0","_npmUser":{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"},"homepage":"https://github.com/danielsimonjr/everything-mcp","keywords":["mcp","everything","search","file-search","windows","es.exe","voidtools","bun"],"repository":{"url":"git+https://github.com/danielsimonjr/everything-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server for Everything search engine - blazing fast file search for Windows","directories":{},"maintainers":[{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"}],"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.2.0","@modelcontextprotocol/core":"^2.0.0","@modelcontextprotocol/server":"^2.0.0"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.2","devDependencies":{"@types/bun":"^1.2.0","typescript":"^7.0.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/everything-mcp_3.2.0_1790183016088_0.9401846708326458"}}},"time":{"created":"2025-11-12T02:47:43.783Z","modified":"2026-09-23T17:03:36.371Z","1.0.0":"2025-11-12T02:47:44.030Z","1.0.1":"2025-12-10T04:37:57.822Z","1.2.0":"2026-08-13T04:24:28.181Z","2.0.0":"2026-09-05T15:52:47.078Z","3.0.0":"2026-09-06T19:48:06.865Z","3.1.0":"2026-09-06T22:23:07.372Z","3.2.0":"2026-09-23T17:03:36.168Z"},"bugs":{"url":"https://github.com/danielsimonjr/everything-mcp/issues"},"author":{"url":"https://github.com/danielsimonjr","name":"Daniel Simon Jr."},"license":"MIT","homepage":"https://github.com/danielsimonjr/everything-mcp","keywords":["mcp","everything","search","file-search","windows","es.exe","voidtools","bun"],"repository":{"url":"git+https://github.com/danielsimonjr/everything-mcp.git","type":"git"},"description":"MCP server for Everything search engine - blazing fast file search for Windows","maintainers":[{"name":"danielsimonjr","email":"danielsimonjr@yahoo.com"}],"readme":"# Everything MCP Server\n\n[![NPM](https://img.shields.io/npm/v/@danielsimonjr/everything-mcp.svg)](https://www.npmjs.com/package/@danielsimonjr/everything-mcp)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-2.0-purple.svg)](https://modelcontextprotocol.io)\n[![Bun](https://img.shields.io/badge/runtime-Bun-fbf0df.svg)](https://bun.sh)\n\nModel Context Protocol (MCP) server for [Everything](https://www.voidtools.com/), the blazing-fast file search engine for Windows. Enables instant file and folder searching through MCP.\n\n## Features\n\n- **Lightning Fast**: Leverages Everything's instant search capabilities\n- **Powerful Search Syntax**: Wildcards, regex, boolean operators, size filters, date filters\n- **File Details**: Get comprehensive file information (size, dates, attributes)\n- **Flexible Filtering**: Filter by type, size, date, attributes, and more\n- **Sorting**: Sort results by name, path, size, extension, or dates\n\n## Prerequisites\n\n**Windows Only** - Everything search engine must be installed:\n\n1. **Download Everything**: https://www.voidtools.com/downloads/\n2. **Install Everything** and let it index your drives\n3. **Verify es.exe** (command-line interface) is available at: `C:\\Program Files\\Everything\\es.exe`\n4. **Bun** (for development / the npm `bin` entry): https://bun.sh\n\n## Installation\n\n### Using Bun (Recommended)\n```bash\nbunx @danielsimonjr/everything-mcp\n```\n\n### Global Installation\n```bash\nbun add -g @danielsimonjr/everything-mcp\n```\n\n### From Source\n```bash\ngit clone https://github.com/danielsimonjr/everything-mcp.git\ncd everything-mcp\nbun install\nbun run build\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n#### Using Bunx\n```json\n{\n  \"mcpServers\": {\n    \"everything\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@danielsimonjr/everything-mcp\"]\n    }\n  }\n}\n```\n\n#### Using Global Install\n```json\n{\n  \"mcpServers\": {\n    \"everything\": {\n      \"command\": \"everything-mcp\"\n    }\n  }\n}\n```\n\n#### Custom es.exe Path\nIf es.exe is not in a probed install location, set the `ES_PATH` environment variable:\n\n```json\n{\n  \"mcpServers\": {\n    \"everything\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@danielsimonjr/everything-mcp\"],\n      \"env\": {\n        \"ES_PATH\": \"C:\\\\\\\\Program Files\\\\\\\\Everything\\\\\\\\es.exe\"\n      }\n    }\n  }\n}\n```\n\n### VS Code\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"everything\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@danielsimonjr/everything-mcp\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### 1. `search`\n\nSearch for files and folders using Everything's powerful search syntax.\n\n**Parameters:**\n- `query` (required): Search query using Everything syntax\n- `maxResults` (optional): Maximum number of results (default: 50)\n- `regex` (optional): Use regular expression search (default: false)\n- `caseSensitive` (optional): Match case (default: false)\n- `wholeWord` (optional): Match whole words only (default: false)\n- `matchPath` (optional): Match full path and filename (default: false)\n- `foldersOnly` (optional): Return only folders (default: false)\n- `filesOnly` (optional): Return only files (default: false)\n- `sortBy` (optional): Sort by name, path, size, extension, date-created, date-modified, date-accessed\n- `sortDescending` (optional): Sort in descending order (default: false)\n- `showSize` (optional): Include file size in results (default: false)\n- `showDateModified` (optional): Include date modified in results (default: false)\n- `parentPath` (optional): Search only within this parent path\n\n**Example:**\n```json\n{\n  \"query\": \"*.js\",\n  \"sortBy\": \"date-modified\",\n  \"sortDescending\": true,\n  \"maxResults\": 20\n}\n```\n\n### 2. `get_file_info`\n\nGet detailed information about a specific file.\n\n**Parameters:**\n- `filename` (required): Full path or filename to get information about\n\n**Returns:** File size, creation date, modification date, access date, and attributes\n\n**Example:**\n```json\n{\n  \"filename\": \"C:\\\\\\\\Users\\\\\\\\username\\\\\\\\document.txt\"\n}\n```\n\n## Companion skill\n\nThis plugin ships a companion skill, `everything` (`everything-mcp:everything`,\nslash trigger `/everything`), at `skills/everything/SKILL.md`. It's a judgment\nlayer over the 2 tools above — no new tools of its own — that steers you\ntoward `search` for name/pattern lookups and `get_file_info` for details on a\nknown path, and flags a machine-specific gotcha: Everything's index excludes\n`~\\Dropbox`, so Dropbox-rooted searches silently miss files and should fall\nback to a filesystem walk (e.g. `fzf-mcp`'s `fuzzy_search_files`) instead.\n\n## Everything Search Syntax\n\nEverything supports powerful search syntax:\n\n### Basic Search\n- **Simple text**: `readme`\n- **Wildcards**: `*.txt`, `file?.doc`\n- **Multiple terms**: `report 2024` (AND is implicit)\n\n### Boolean Operators\n- **AND**: `file AND document` or `file document`\n- **OR**: `txt OR doc`\n- **NOT**: `NOT backup` or `!backup`\n\n### File Extensions\n- **Single**: `ext:jpg`\n- **Multiple**: `ext:jpg;png;gif`\n\n### Size Filters\n- **Exact**: `size:1024kb`\n- **Greater than**: `size:>1mb`\n- **Less than**: `size:<100kb`\n- **Range**: `size:1mb..10mb`\n\n### Date Filters\n- **Modified**: `dm:today`, `dm:lastweek`, `dm:2024`\n- **Created**: `dc:yesterday`\n- **Accessed**: `da:thismonth`\n\n### Attributes\n- **Hidden**: `attrib:H`\n- **Read-only**: `attrib:R`\n- **System**: `attrib:S`\n- **Directory**: `attrib:D`\n\n### Path Matching\n- **In folder**: `path:C:\\\\Users\\\\`\n- **Parent**: `parent:Downloads`\n\n### Advanced\n- **Regex**: Enable with `regex: true` parameter\n- **Case-sensitive**: Enable with `caseSensitive: true`\n- **Whole word**: Enable with `wholeWord: true`\n\nSee [Everything Search Syntax](https://www.voidtools.com/support/everything/searching/) for complete reference.\n\n## Usage Examples\n\n### Example 1: Find Recent JavaScript Files\n\nTell Claude:\n```\nUse Everything to find all JavaScript files modified in the last week, sorted by date\n```\n\nClaude will use:\n```json\n{\n  \"query\": \"*.js dm:lastweek\",\n  \"sortBy\": \"date-modified\",\n  \"sortDescending\": true,\n  \"maxResults\": 50\n}\n```\n\n### Example 2: Find Large Files\n\nTell Claude:\n```\nFind all files larger than 100MB\n```\n\nClaude will use:\n```json\n{\n  \"query\": \"size:>100mb\",\n  \"showSize\": true,\n  \"sortBy\": \"size\",\n  \"sortDescending\": true\n}\n```\n\n### Example 3: Search in Specific Directory\n\nTell Claude:\n```\nFind all Python files in my Documents folder\n```\n\nClaude will use:\n```json\n{\n  \"query\": \"*.py\",\n  \"parentPath\": \"C:\\\\\\\\Users\\\\\\\\username\\\\\\\\Documents\"\n}\n```\n\n### Example 4: Get File Information\n\nTell Claude:\n```\nGet detailed information about C:\\\\config.json\n```\n\nClaude will use:\n```json\n{\n  \"filename\": \"C:\\\\\\\\config.json\"\n}\n```\n\n## How It Works\n\n1. **Everything Service**: Everything runs as a Windows service, maintaining a real-time index of all files\n2. **es.exe**: Command-line interface to query the Everything database\n3. **MCP Server**: Wraps es.exe and provides MCP tools for Claude\n4. **Instant Results**: Searches complete in milliseconds, even across millions of files\n\n## Troubleshooting\n\n### Everything Not Found\n\n**Error:** `Failed to execute es.exe`\n\n**Solutions:**\n1. Verify Everything is installed: Download from https://www.voidtools.com/\n2. Ensure Everything service is running (check system tray)\n3. Verify es.exe location:\n   - Default: `C:\\\\Program Files\\\\Everything\\\\es.exe`\n   - Scoop: `C:\\\\Users\\\\<username>\\\\scoop\\\\apps\\\\everything\\\\current\\\\es.exe`\n4. Set `ES_PATH` environment variable in MCP config\n\n### No Results Found\n\n**Causes:**\n- Query doesn't match any files\n- Everything database not fully indexed yet\n- Incorrect search syntax\n\n**Solutions:**\n- Try a broader search term\n- Check Everything GUI to verify files are indexed\n- Review search syntax\n\n### Permission Issues\n\n**Issue:** Can't access certain directories\n\n**Solution:** Run Everything as administrator or adjust folder permissions\n\n## Development\n\n```bash\n# Clone repository\ngit clone https://github.com/danielsimonjr/everything-mcp.git\ncd everything-mcp\n\n# Install dependencies (Bun)\nbun install\n\n# Typecheck / test / build plugin bundle\nbun run typecheck\nbun test\nbun run build\n\n# Run locally over stdio\nbun run src/index.ts\n\n# Live initialize + tools/list smoke test\nbun run smoke\n```\n\n## Contributing\n\nContributions welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Test thoroughly\n5. Submit a pull request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [Everything](https://www.voidtools.com/) by voidtools - The amazing search engine\n- [Model Context Protocol](https://modelcontextprotocol.io) by Anthropic\n\n## Links\n\n- **NPM Package:** https://www.npmjs.com/package/@danielsimonjr/everything-mcp\n- **GitHub Repository:** https://github.com/danielsimonjr/everything-mcp\n- **Everything Search:** https://www.voidtools.com/\n- **MCP Documentation:** https://modelcontextprotocol.io\n\n---\n\n**Made with ❤️ for the MCP community**\n","readmeFilename":"README.md"}