{
  "markdown": "<div align=\"center\">\n  <h1>⚡ Everything MCP</h1>\n  <p>\n    <strong>MCP server for <a href=\"https://www.voidtools.com/\">voidtools Everything</a> - search millions of Windows files in milliseconds from any AI agent.</strong>\n  </p>\n  <p>\n    <a href=\"https://pypi.org/project/everything-mcp/\"><img alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/everything-mcp.svg?cacheSeconds=300&v=20260204\"></a>\n    <a href=\"https://pypi.org/project/everything-mcp/\"><img alt=\"Python\" src=\"https://img.shields.io/pypi/pyversions/everything-mcp.svg?cacheSeconds=300&v=20260204\"></a>\n    <a href=\"LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/github/license/elis132/everything-mcp.svg?cacheSeconds=300&v=20260204\"></a>\n  </p>\n</div>\n\n---\n\n## Quick start\n\n```\n/plugin marketplace add elis132/everything-mcp\n/plugin install everything-mcp@everything-mcp\n```\n\nThat's it for Claude Code - the plugin bundles the MCP server and a skill that teaches the query syntax. For every other client, see [Installation](#installation) below.\n\n## Why this one\n\n|  | **everything-mcp** (this) | [mamertofabian](https://github.com/mamertofabian/mcp-everything-search) (342⭐) | [Josephur](https://github.com/Josephur/everything-mcp) (26⭐) | essovius |\n|---|---|---|---|---|\n| Tools | 5 | 1 | 1 | 16 |\n| Setup | Auto-detects es.exe | Manual SDK DLL path | Manual HTTP server + host/port | Manual es.exe in PATH |\n| Everything 1.5 | Auto-detects instance | Not supported | Untested | Manual flag |\n| Talks to Everything via | `es.exe` subprocess | Everything SDK (DLL) | Everything's HTTP server plugin (unauthenticated) | `es.exe` subprocess |\n| Tests / CI | pytest, GitHub Actions | None visible | None visible | None visible |\n\n## Performance\n\n`es.exe` (Everything's real-time NTFS index) vs. a naive filesystem walk, same query:\n\n- **everything-mcp**: 220 ms avg (5 runs)\n- **Naive walk of `C:\\`**: 66,539 ms\n- **~300x faster**\n\n<details>\n<summary>Reproduce this benchmark</summary>\n\n```powershell\n@'\nimport os, subprocess, time, statistics\n\nES = os.path.expandvars(r\"%LOCALAPPDATA%\\Everything\\es.exe\")\nQUERY = \"everything.exe\"\n\nes_runs = []\nfor _ in range(5):\n    t0 = time.perf_counter()\n    subprocess.run([ES, \"-n\", \"100\", QUERY], capture_output=True, text=True)\n    es_runs.append((time.perf_counter() - t0) * 1000)\n\nt0 = time.perf_counter()\nmatches = []\nfor dirpath, _, filenames in os.walk(r\"C:\\\\\"):\n    for name in filenames:\n        if name.lower() == QUERY:\n            matches.append(os.path.join(dirpath, name))\nwalk_ms = (time.perf_counter() - t0) * 1000\n\nes_avg = statistics.mean(es_runs)\nprint(\"ES avg ms:\", round(es_avg, 2))\nprint(\"Walk ms:\", round(walk_ms, 2))\nprint(\"Speedup x:\", round(walk_ms / es_avg, 1))\nprint(\"Matches:\", len(matches))\n'@ | python -\n```\n</details>\n\n---\n\n## Installation\n\n### Prerequisites\n\n1. **Windows** with [Everything](https://www.voidtools.com/) installed and **running**\n2. **es.exe** (Everything's command-line interface) - included with Everything 1.5 alpha, or install separately:\n   - `winget install voidtools.Everything.Cli`\n   - `scoop install everything-cli`\n   - `choco install es`\n   - or download from [github.com/voidtools/es](https://github.com/voidtools/es/releases) and place it in your PATH\n3. **Python 3.10+** or **uv**\n\n### Run the server\n\n```bash\nuvx everything-mcp          # recommended, no install needed\npip install everything-mcp  # or via pip\n```\n\nFrom source:\n\n```bash\ngit clone https://github.com/elis132/everything-mcp.git\ncd everything-mcp && pip install -e \".[dev]\"\n```\n\n### Add it to your client\n\nEvery client below uses the same MCP server definition:\n\n```json\n{\n  \"mcpServers\": {\n    \"everything\": {\n      \"command\": \"uvx\",\n      \"args\": [\"everything-mcp\"]\n    }\n  }\n}\n```\n\n| Client | How to add it |\n|---|---|\n| **Claude Code** | `/plugin install everything-mcp@everything-mcp` (see [Quick start](#quick-start)), or `claude mcp add everything -- uvx everything-mcp` |\n| **Claude Desktop** | Paste the JSON above into `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| **Codex CLI** | `codex mcp add everything -- uvx everything-mcp` |\n| **Gemini CLI** | `gemini mcp add -s user everything uvx everything-mcp` |\n| **Kimi CLI** | `kimi mcp add --transport stdio everything -- uvx everything-mcp` |\n| **Qwen CLI** | `qwen mcp add -s user everything uvx everything-mcp` |\n| **Cursor** | Paste the JSON above into Cursor's MCP settings UI |\n| **Windsurf** | Paste the JSON above into `%USERPROFILE%\\.codeium\\windsurf\\mcp_config.json` |\n| **Any other MCP client** | Use the JSON above verbatim |\n\n<details>\n<summary>Using pip instead of uvx</summary>\n\n```json\n{ \"mcpServers\": { \"everything\": { \"command\": \"everything-mcp\" } } }\n```\n\nOr with explicit Python: `{\"command\": \"python\", \"args\": [\"-m\", \"everything_mcp\"]}`\n</details>\n\n### Environment variables (optional)\n\nEverything MCP auto-detects your setup, but you can override:\n\n| Variable | Description | Example |\n|---|---|---|\n| `EVERYTHING_ES_PATH` | Path to es.exe | `C:\\Program Files\\Everything\\es.exe` |\n| `EVERYTHING_INSTANCE` | Named Everything instance | `1.5a` |\n| `EVERYTHING_MAX_RESULTS_CAP` | Hard cap on results per search (default `1000`) | `200` |\n\n> Only set `EVERYTHING_INSTANCE` if you explicitly configured a named instance\n> in Everything (Tools → Options → General → Instance). Most installs -\n> including most Everything 1.5 installs - run on the **default** instance;\n> setting this unnecessarily breaks the connection. If in doubt, leave it out.\n\n```json\n{\n  \"mcpServers\": {\n    \"everything\": {\n      \"command\": \"uvx\",\n      \"args\": [\"everything-mcp\"],\n      \"env\": { \"EVERYTHING_INSTANCE\": \"1.5a\" }\n    }\n  }\n}\n```\n\n---\n\n## Tools\n\n### 1. `everything_search` - the workhorse\n\n| Parameter | Default | Description |\n|---|---|---|\n| `query` | *(required)* | Everything search query |\n| `max_results` | 50 | 1-500 |\n| `sort` | `date-modified-desc` | name, path, size, date-modified, date-created, extension (+ `-desc` variants) |\n| `match_case` / `match_whole_word` / `match_regex` / `match_path` | false | Match modifiers |\n| `offset` | 0 | Pagination offset |\n\n**Query syntax:**\n\n```\n*.py                          all Python files\next:py;js;ts                  multiple extensions\next:py path:C:\\Projects       Python files under a path\nsize:>10mb                    larger than 10 MB\nsize:1kb..1mb                 between 1 KB and 1 MB\ndm:today / dm:last1week       modified today / in the last week\ndc:2024                       created in 2024\n\"exact name.txt\"              exact filename match\nproject1 | project2           OR search\n!node_modules                 exclude a term\ncontent:TODO                  files containing TODO (needs content indexing)\nregex:^test_.*\\.py$           regex search\nparent:src ext:py             files directly inside 'src' folders\ndupe:  /  empty:               duplicate filenames / empty folders\n```\n\n### 2. `everything_search_by_type` - category search\n\nCategories: `audio`, `video`, `image`, `document`, `code`, `archive`, `executable`, `font`, `3d`, `data`\n\nParameters: `file_type` *(required)*, `query`, `path`, `max_results`, `sort`\n\n### 3. `everything_find_recent` - what changed?\n\nPeriods: `1min` … `12hours`, `today`, `yesterday`, `1day` … `1year`\n\nParameters: `period` (default `1hour`), `path`, `extensions`, `query`, `max_results`\n\n### 4. `everything_file_details` - deep inspection\n\nParameters: `paths` *(required, 1-20)*, `preview_lines` (0-200)\n\nReturns full metadata; for directories, item count and listing; for text files with a preview, the first N lines.\n\n### 5. `everything_count_stats` - quick analytics\n\nParameters: `query` *(required)*, `include_size` (default true), `breakdown_by_extension`\n\nCount and size stats without listing every file - check scope before a big search.\n\n---\n\n## Examples\n\n| Ask | Call |\n|---|---|\n| Python files modified today in my project | `everything_find_recent(period=\"today\", extensions=\"py\", path=\"C:\\Projects\\myapp\")` |\n| How much space do my log files use? | `everything_count_stats(query=\"ext:log\", include_size=true, breakdown_by_extension=true)` |\n| First 50 lines of a config file | `everything_file_details(paths=[\"C:\\Projects\\app\\config.yaml\"], preview_lines=50)` |\n| Duplicate filenames in Documents | `everything_search(query='dupe: path:\"C:\\Users\\me\\Documents\"')` |\n| Images larger than 5MB | `everything_search(query=\"ext:jpg;png;gif size:>5mb\")` |\n\n---\n\n## Troubleshooting\n\n**\"es.exe not found\"** - Install [Everything](https://www.voidtools.com/) and [es.exe](https://github.com/voidtools/es/releases), or set `EVERYTHING_ES_PATH`.\n\n**\"Everything IPC window not found\"** - Make sure Everything is running (check the system tray). If you set `EVERYTHING_INSTANCE`, try removing it - most installs don't need it. Everything Lite doesn't support IPC.\n\n**No results for valid queries** - Confirm Everything's index has finished building, try the same query in Everything's GUI, and check the drive/path is included in Everything's index settings.\n\n**Debugging:**\n\n```bash\neverything-mcp 2>everything-mcp.log                        # server logs\nnpx @modelcontextprotocol/inspector uvx everything-mcp      # MCP Inspector\n```\n\n---\n\n## Development\n\n```bash\npip install -e \".[dev]\"   # install with dev dependencies\npytest                    # run tests\nruff check src/ tests/    # lint\n```\n\nContributions welcome - see [CLAUDE.md](CLAUDE.md) for the architecture and design decisions. Areas of interest: direct named-pipe IPC, Everything SDK3 for 1.5, content search, file-watching, bookmark/tag support.\n\n## License\n\nMIT - see [LICENSE](LICENSE)\n\n## Acknowledgments\n\n[voidtools](https://www.voidtools.com/) for Everything, [Anthropic](https://anthropic.com/) for the Model Context Protocol, and the MCP community.\n\n<!-- mcp-name: io.github.elis132/everything-mcp -->\n",
  "bytes": 9791,
  "sha": "822175f9158c16e978c6f96b9e6c755bd9532b057abc96785903a98141e06b28",
  "repo_slug": "elis132/everything-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_elis132_everything_mcp_43d3c7f0/readme"
}