everything-mcp 1.0.1__tar.gz → 1.0.3__tar.gz

{everything_mcp-1.0.1 → everything_mcp-1.0.3}/CHANGELOG.md

@@ -1,8 +1,21 @@
 # Changelog
 
-All notable changes to **everything-mcp** will be documented in this file.
+All notable changes to **everything-mcp** will be documented in this file.
+
+## [1.0.3] - 2026-02-04
+
+### Changed
+
+- Replaced em-dash punctuation with ASCII hyphens (`-`) across docs and source text.
+
+## [1.0.2] - 2026-02-04
+
+### Changed
 
-## [1.0.1] ? 2026-02-04
+- Updated package metadata author to `elis132` (removed author email from PyPI metadata).
+- Updated LICENSE copyright holder name to `elis132`.
+
+## [1.0.1] - 2026-02-04
 
 ### Fixed
 
@@ -10,7 +23,7 @@ All notable changes to **everything-mcp** will be documented in this file.
 - Updated backend aggregate queries to avoid incompatible `es.exe` flag combinations (`-n 0` with `-get-result-count` / `-get-total-size`).
 - Added backend tests to verify aggregate command construction.
 
-## [1.0.0] — 2026-02-04
+## [1.0.0] - 2026-02-04
 
 ### Added
 

{everything_mcp-1.0.1 → everything_mcp-1.0.3}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Elis
+Copyright (c) 2026 elis132
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{everything_mcp-1.0.1 → everything_mcp-1.0.3}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: everything-mcp
-Version: 1.0.1
-Summary: The definitive MCP server for voidtools Everything — lightning-fast file search for AI agents
+Version: 1.0.3
+Summary: The definitive MCP server for voidtools Everything - lightning-fast file search for AI agents
 Project-URL: Homepage, https://github.com/elis132/everything-mcp
 Project-URL: Repository, https://github.com/elis132/everything-mcp
 Project-URL: Issues, https://github.com/elis132/everything-mcp/issues
 Project-URL: Changelog, https://github.com/elis132/everything-mcp/blob/main/CHANGELOG.md
-Author-email: Elis <elis@egf.se>
+Author: elis132
 License: MIT
 License-File: LICENSE
 Keywords: ai-agent,claude,codex,everything,file-search,gemini,mcp,model-context-protocol,voidtools
@@ -34,7 +34,7 @@ Description-Content-Type: text/markdown
 <div align="center">
   <h1>⚡ Everything MCP</h1>
   <p>
-    <strong>The definitive MCP server for <a href="https://www.voidtools.com/">voidtools Everything</a> ? lightning-fast file search for AI agents.</strong>
+    <strong>The definitive MCP server for <a href="https://www.voidtools.com/">voidtools Everything</a> - lightning-fast file search for AI agents.</strong>
   </p>
   <p>
     <a href="https://pypi.org/project/everything-mcp/"><img alt="PyPI" src="https://img.shields.io/pypi/v/everything-mcp"></a>
@@ -60,6 +60,48 @@ Description-Content-Type: text/markdown
 | **Test suite** | ✅ pytest | ❌ | ❌ |
 | **Zero config** | ✅ Works out of the box | ❌ Need SDK DLL path | ❌ Need es.exe in PATH |
 
+## Performance
+
+Real benchmark from this machine (Windows, query: `everything.exe`):
+
+- `everything-mcp` (Everything index via `es.exe`): **220.22 ms avg** (5 runs)
+- Naive filesystem walk over `C:\`: **66,539.03 ms** (single run)
+- Observed speedup: **~302x faster**
+
+Reproduce locally (PowerShell):
+
+```powershell
+@'
+import os
+import subprocess
+import time
+import statistics
+
+ES = os.path.expandvars(r"%LOCALAPPDATA%\Everything\es.exe")
+QUERY = "everything.exe"
+
+es_runs = []
+for _ in range(5):
+    t0 = time.perf_counter()
+    subprocess.run([ES, "-n", "100", QUERY], capture_output=True, text=True)
+    es_runs.append((time.perf_counter() - t0) * 1000)
+
+t0 = time.perf_counter()
+matches = []
+for dirpath, _, filenames in os.walk(r"C:\\"):
+    for name in filenames:
+        if name.lower() == QUERY:
+            matches.append(os.path.join(dirpath, name))
+walk_ms = (time.perf_counter() - t0) * 1000
+
+es_avg = statistics.mean(es_runs)
+print("ES avg ms:", round(es_avg, 2))
+print("Walk ms:", round(walk_ms, 2))
+print("Speedup x:", round(walk_ms / es_avg, 1))
+print("Matches:", len(matches))
+'@ | python -
+```
+
 ## Installation
 
 ### Prerequisites
@@ -71,7 +113,7 @@ Description-Content-Type: text/markdown
    - Place `es.exe` in your PATH or in the Everything installation directory
 3. **Python 3.10+** or **uv**
 
-### Via uv (recommended — no install needed)
+### Via uv (recommended - no install needed)
 
 ```bash
 uvx everything-mcp
@@ -286,7 +328,7 @@ Everything MCP auto-detects your setup, but you can override:
 
 ## Tools
 
-### 1. `everything_search` — The Workhorse
+### 1. `everything_search` - The Workhorse
 
 Search files and folders using Everything's full query syntax.
 
@@ -323,7 +365,7 @@ dupe:                         → Duplicate filenames
 empty:                        → Empty folders
 ```
 
-### 2. `everything_search_by_type` — Category Search
+### 2. `everything_search_by_type` - Category Search
 
 Search by pre-defined file type categories.
 
@@ -337,7 +379,7 @@ Search by pre-defined file type categories.
 | `max_results` | 50 | 1–500 |
 | `sort` | `date-modified-desc` | Sort order |
 
-### 3. `everything_find_recent` — What Changed?
+### 3. `everything_find_recent` - What Changed?
 
 Find recently modified files. Sorted newest-first.
 
@@ -351,7 +393,7 @@ Find recently modified files. Sorted newest-first.
 | `query` | `""` | Additional filter |
 | `max_results` | 50 | 1–500 |
 
-### 4. `everything_file_details` — Deep Inspection
+### 4. `everything_file_details` - Deep Inspection
 
 Get metadata and optional content preview for specific files.
 
@@ -362,7 +404,7 @@ Get metadata and optional content preview for specific files.
 
 **Returns:** Full metadata (size, dates, permissions, hidden status). Directories: item count and listing. Text files with preview: first N lines of content.
 
-### 5. `everything_count_stats` — Quick Analytics
+### 5. `everything_count_stats` - Quick Analytics
 
 Get count and size statistics without listing individual files.
 
@@ -489,7 +531,7 @@ Contributions welcome! Areas for improvement:
 
 ## License
 
-MIT — see [LICENSE](LICENSE)
+MIT - see [LICENSE](LICENSE)
 
 ## Acknowledgments
 

{everything_mcp-1.0.1 → everything_mcp-1.0.3}/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <h1>⚡ Everything MCP</h1>
   <p>
-    <strong>The definitive MCP server for <a href="https://www.voidtools.com/">voidtools Everything</a> ? lightning-fast file search for AI agents.</strong>
+    <strong>The definitive MCP server for <a href="https://www.voidtools.com/">voidtools Everything</a> - lightning-fast file search for AI agents.</strong>
   </p>
   <p>
     <a href="https://pypi.org/project/everything-mcp/"><img alt="PyPI" src="https://img.shields.io/pypi/v/everything-mcp"></a>
@@ -27,6 +27,48 @@
 | **Test suite** | ✅ pytest | ❌ | ❌ |
 | **Zero config** | ✅ Works out of the box | ❌ Need SDK DLL path | ❌ Need es.exe in PATH |
 
+## Performance
+
+Real benchmark from this machine (Windows, query: `everything.exe`):
+
+- `everything-mcp` (Everything index via `es.exe`): **220.22 ms avg** (5 runs)
+- Naive filesystem walk over `C:\`: **66,539.03 ms** (single run)
+- Observed speedup: **~302x faster**
+
+Reproduce locally (PowerShell):
+
+```powershell
+@'
+import os
+import subprocess
+import time
+import statistics
+
+ES = os.path.expandvars(r"%LOCALAPPDATA%\Everything\es.exe")
+QUERY = "everything.exe"
+
+es_runs = []
+for _ in range(5):
+    t0 = time.perf_counter()
+    subprocess.run([ES, "-n", "100", QUERY], capture_output=True, text=True)
+    es_runs.append((time.perf_counter() - t0) * 1000)
+
+t0 = time.perf_counter()
+matches = []
+for dirpath, _, filenames in os.walk(r"C:\\"):
+    for name in filenames:
+        if name.lower() == QUERY:
+            matches.append(os.path.join(dirpath, name))
+walk_ms = (time.perf_counter() - t0) * 1000
+
+es_avg = statistics.mean(es_runs)
+print("ES avg ms:", round(es_avg, 2))
+print("Walk ms:", round(walk_ms, 2))
+print("Speedup x:", round(walk_ms / es_avg, 1))
+print("Matches:", len(matches))
+'@ | python -
+```
+
 ## Installation
 
 ### Prerequisites
@@ -38,7 +80,7 @@
    - Place `es.exe` in your PATH or in the Everything installation directory
 3. **Python 3.10+** or **uv**
 
-### Via uv (recommended — no install needed)
+### Via uv (recommended - no install needed)
 
 ```bash
 uvx everything-mcp
@@ -253,7 +295,7 @@ Everything MCP auto-detects your setup, but you can override:
 
 ## Tools
 
-### 1. `everything_search` — The Workhorse
+### 1. `everything_search` - The Workhorse
 
 Search files and folders using Everything's full query syntax.
 
@@ -290,7 +332,7 @@ dupe:                         → Duplicate filenames
 empty:                        → Empty folders
 ```
 
-### 2. `everything_search_by_type` — Category Search
+### 2. `everything_search_by_type` - Category Search
 
 Search by pre-defined file type categories.
 
@@ -304,7 +346,7 @@ Search by pre-defined file type categories.
 | `max_results` | 50 | 1–500 |
 | `sort` | `date-modified-desc` | Sort order |
 
-### 3. `everything_find_recent` — What Changed?
+### 3. `everything_find_recent` - What Changed?
 
 Find recently modified files. Sorted newest-first.
 
@@ -318,7 +360,7 @@ Find recently modified files. Sorted newest-first.
 | `query` | `""` | Additional filter |
 | `max_results` | 50 | 1–500 |
 
-### 4. `everything_file_details` — Deep Inspection
+### 4. `everything_file_details` - Deep Inspection
 
 Get metadata and optional content preview for specific files.
 
@@ -329,7 +371,7 @@ Get metadata and optional content preview for specific files.
 
 **Returns:** Full metadata (size, dates, permissions, hidden status). Directories: item count and listing. Text files with preview: first N lines of content.
 
-### 5. `everything_count_stats` — Quick Analytics
+### 5. `everything_count_stats` - Quick Analytics
 
 Get count and size statistics without listing individual files.
 
@@ -456,7 +498,7 @@ Contributions welcome! Areas for improvement:
 
 ## License
 
-MIT — see [LICENSE](LICENSE)
+MIT - see [LICENSE](LICENSE)
 
 ## Acknowledgments
 

{everything_mcp-1.0.1 → everything_mcp-1.0.3}/pyproject.toml

@@ -1,80 +1,80 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "everything-mcp"
-version = "1.0.1"
-description = "The definitive MCP server for voidtools Everything — lightning-fast file search for AI agents"
-readme = "README.md"
-license = { text = "MIT" }
-requires-python = ">=3.10"
-authors = [
-    { name = "Elis", email = "elis@egf.se" },
-]
-keywords = [
-    "mcp", "everything", "voidtools", "file-search", "claude",
-    "codex", "gemini", "ai-agent", "model-context-protocol",
-]
-classifiers = [
-    "Development Status :: 5 - Production/Stable",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: Microsoft :: Windows",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Topic :: Software Development :: Libraries",
-    "Topic :: System :: Filesystems",
-    "Typing :: Typed",
-]
-dependencies = [
-    "mcp>=1.0.0",
-    "pydantic>=2.0.0",
-]
-
-[project.optional-dependencies]
-dev = [
-    "pytest>=8.0",
-    "pytest-asyncio>=0.23",
-    "ruff>=0.4",
-]
-
-[project.urls]
-Homepage = "https://github.com/elis132/everything-mcp"
-Repository = "https://github.com/elis132/everything-mcp"
-Issues = "https://github.com/elis132/everything-mcp/issues"
-Changelog = "https://github.com/elis132/everything-mcp/blob/main/CHANGELOG.md"
-
-[project.scripts]
-everything-mcp = "everything_mcp:main"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/everything_mcp"]
-
-[tool.hatch.build.targets.sdist]
-include = ["src/everything_mcp", "README.md", "LICENSE", "CHANGELOG.md", "pyproject.toml"]
-
-# ── Testing ───────────────────────────────────────────────────────────────
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-asyncio_mode = "auto"
-filterwarnings = [
-    "ignore::DeprecationWarning",
-]
-
-# ── Linting ───────────────────────────────────────────────────────────────
-
-[tool.ruff]
-target-version = "py310"
-line-length = 100
-
-[tool.ruff.lint]
-select = ["E", "F", "W", "I", "UP", "B", "SIM"]
-ignore = ["E501"]  # line length handled by formatter
-
-[tool.ruff.lint.isort]
-known-first-party = ["everything_mcp"]
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "everything-mcp"
+version = "1.0.3"
+description = "The definitive MCP server for voidtools Everything - lightning-fast file search for AI agents"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "elis132" },
+]
+keywords = [
+    "mcp", "everything", "voidtools", "file-search", "claude",
+    "codex", "gemini", "ai-agent", "model-context-protocol",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Filesystems",
+    "Typing :: Typed",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.4",
+]
+
+[project.urls]
+Homepage = "https://github.com/elis132/everything-mcp"
+Repository = "https://github.com/elis132/everything-mcp"
+Issues = "https://github.com/elis132/everything-mcp/issues"
+Changelog = "https://github.com/elis132/everything-mcp/blob/main/CHANGELOG.md"
+
+[project.scripts]
+everything-mcp = "everything_mcp:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/everything_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/everything_mcp", "README.md", "LICENSE", "CHANGELOG.md", "pyproject.toml"]
+
+# ── Testing ───────────────────────────────────────────────────────────────
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+filterwarnings = [
+    "ignore::DeprecationWarning",
+]
+
+# ── Linting ───────────────────────────────────────────────────────────────
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM"]
+ignore = ["E501"]  # line length handled by formatter
+
+[tool.ruff.lint.isort]
+known-first-party = ["everything_mcp"]

{everything_mcp-1.0.1 → everything_mcp-1.0.3}/src/everything_mcp/__init__.py

@@ -1,14 +1,14 @@
-"""
-Everything MCP — The definitive MCP server for voidtools Everything.
-
-Lightning-fast file search for AI agents.
-"""
-
-__version__ = "1.0.1"
-
-
-def main() -> None:
-    """Entry point for the ``everything-mcp`` command."""
-    from everything_mcp.server import mcp
-
-    mcp.run()
+"""
+Everything MCP - The definitive MCP server for voidtools Everything.
+
+Lightning-fast file search for AI agents.
+"""
+
+__version__ = "1.0.3"
+
+
+def main() -> None:
+    """Entry point for the ``everything-mcp`` command."""
+    from everything_mcp.server import mcp
+
+    mcp.run()