everything-mcp 1.0.1__py3-none-any.whl → 1.0.3__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- everything_mcp/__init__.py +14 -14
- everything_mcp/backend.py +455 -455
- everything_mcp/config.py +253 -253
- everything_mcp/server.py +745 -745
- {everything_mcp-1.0.1.dist-info → everything_mcp-1.0.3.dist-info}/METADATA +53 -11
- everything_mcp-1.0.3.dist-info/RECORD +11 -0
- {everything_mcp-1.0.1.dist-info → everything_mcp-1.0.3.dist-info}/licenses/LICENSE +1 -1
- everything_mcp-1.0.1.dist-info/RECORD +0 -11
- {everything_mcp-1.0.1.dist-info → everything_mcp-1.0.3.dist-info}/WHEEL +0 -0
- {everything_mcp-1.0.1.dist-info → everything_mcp-1.0.3.dist-info}/entry_points.txt +0 -0
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: everything-mcp
|
|
3
|
-
Version: 1.0.
|
|
4
|
-
Summary: The definitive MCP server for voidtools Everything
|
|
3
|
+
Version: 1.0.3
|
|
4
|
+
Summary: The definitive MCP server for voidtools Everything - lightning-fast file search for AI agents
|
|
5
5
|
Project-URL: Homepage, https://github.com/elis132/everything-mcp
|
|
6
6
|
Project-URL: Repository, https://github.com/elis132/everything-mcp
|
|
7
7
|
Project-URL: Issues, https://github.com/elis132/everything-mcp/issues
|
|
8
8
|
Project-URL: Changelog, https://github.com/elis132/everything-mcp/blob/main/CHANGELOG.md
|
|
9
|
-
Author
|
|
9
|
+
Author: elis132
|
|
10
10
|
License: MIT
|
|
11
11
|
License-File: LICENSE
|
|
12
12
|
Keywords: ai-agent,claude,codex,everything,file-search,gemini,mcp,model-context-protocol,voidtools
|
|
@@ -34,7 +34,7 @@ Description-Content-Type: text/markdown
|
|
|
34
34
|
<div align="center">
|
|
35
35
|
<h1>⚡ Everything MCP</h1>
|
|
36
36
|
<p>
|
|
37
|
-
<strong>The definitive MCP server for <a href="https://www.voidtools.com/">voidtools Everything</a>
|
|
37
|
+
<strong>The definitive MCP server for <a href="https://www.voidtools.com/">voidtools Everything</a> - lightning-fast file search for AI agents.</strong>
|
|
38
38
|
</p>
|
|
39
39
|
<p>
|
|
40
40
|
<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
|
|
|
60
60
|
| **Test suite** | ✅ pytest | ❌ | ❌ |
|
|
61
61
|
| **Zero config** | ✅ Works out of the box | ❌ Need SDK DLL path | ❌ Need es.exe in PATH |
|
|
62
62
|
|
|
63
|
+
## Performance
|
|
64
|
+
|
|
65
|
+
Real benchmark from this machine (Windows, query: `everything.exe`):
|
|
66
|
+
|
|
67
|
+
- `everything-mcp` (Everything index via `es.exe`): **220.22 ms avg** (5 runs)
|
|
68
|
+
- Naive filesystem walk over `C:\`: **66,539.03 ms** (single run)
|
|
69
|
+
- Observed speedup: **~302x faster**
|
|
70
|
+
|
|
71
|
+
Reproduce locally (PowerShell):
|
|
72
|
+
|
|
73
|
+
```powershell
|
|
74
|
+
@'
|
|
75
|
+
import os
|
|
76
|
+
import subprocess
|
|
77
|
+
import time
|
|
78
|
+
import statistics
|
|
79
|
+
|
|
80
|
+
ES = os.path.expandvars(r"%LOCALAPPDATA%\Everything\es.exe")
|
|
81
|
+
QUERY = "everything.exe"
|
|
82
|
+
|
|
83
|
+
es_runs = []
|
|
84
|
+
for _ in range(5):
|
|
85
|
+
t0 = time.perf_counter()
|
|
86
|
+
subprocess.run([ES, "-n", "100", QUERY], capture_output=True, text=True)
|
|
87
|
+
es_runs.append((time.perf_counter() - t0) * 1000)
|
|
88
|
+
|
|
89
|
+
t0 = time.perf_counter()
|
|
90
|
+
matches = []
|
|
91
|
+
for dirpath, _, filenames in os.walk(r"C:\\"):
|
|
92
|
+
for name in filenames:
|
|
93
|
+
if name.lower() == QUERY:
|
|
94
|
+
matches.append(os.path.join(dirpath, name))
|
|
95
|
+
walk_ms = (time.perf_counter() - t0) * 1000
|
|
96
|
+
|
|
97
|
+
es_avg = statistics.mean(es_runs)
|
|
98
|
+
print("ES avg ms:", round(es_avg, 2))
|
|
99
|
+
print("Walk ms:", round(walk_ms, 2))
|
|
100
|
+
print("Speedup x:", round(walk_ms / es_avg, 1))
|
|
101
|
+
print("Matches:", len(matches))
|
|
102
|
+
'@ | python -
|
|
103
|
+
```
|
|
104
|
+
|
|
63
105
|
## Installation
|
|
64
106
|
|
|
65
107
|
### Prerequisites
|
|
@@ -71,7 +113,7 @@ Description-Content-Type: text/markdown
|
|
|
71
113
|
- Place `es.exe` in your PATH or in the Everything installation directory
|
|
72
114
|
3. **Python 3.10+** or **uv**
|
|
73
115
|
|
|
74
|
-
### Via uv (recommended
|
|
116
|
+
### Via uv (recommended - no install needed)
|
|
75
117
|
|
|
76
118
|
```bash
|
|
77
119
|
uvx everything-mcp
|
|
@@ -286,7 +328,7 @@ Everything MCP auto-detects your setup, but you can override:
|
|
|
286
328
|
|
|
287
329
|
## Tools
|
|
288
330
|
|
|
289
|
-
### 1. `everything_search`
|
|
331
|
+
### 1. `everything_search` - The Workhorse
|
|
290
332
|
|
|
291
333
|
Search files and folders using Everything's full query syntax.
|
|
292
334
|
|
|
@@ -323,7 +365,7 @@ dupe: → Duplicate filenames
|
|
|
323
365
|
empty: → Empty folders
|
|
324
366
|
```
|
|
325
367
|
|
|
326
|
-
### 2. `everything_search_by_type`
|
|
368
|
+
### 2. `everything_search_by_type` - Category Search
|
|
327
369
|
|
|
328
370
|
Search by pre-defined file type categories.
|
|
329
371
|
|
|
@@ -337,7 +379,7 @@ Search by pre-defined file type categories.
|
|
|
337
379
|
| `max_results` | 50 | 1–500 |
|
|
338
380
|
| `sort` | `date-modified-desc` | Sort order |
|
|
339
381
|
|
|
340
|
-
### 3. `everything_find_recent`
|
|
382
|
+
### 3. `everything_find_recent` - What Changed?
|
|
341
383
|
|
|
342
384
|
Find recently modified files. Sorted newest-first.
|
|
343
385
|
|
|
@@ -351,7 +393,7 @@ Find recently modified files. Sorted newest-first.
|
|
|
351
393
|
| `query` | `""` | Additional filter |
|
|
352
394
|
| `max_results` | 50 | 1–500 |
|
|
353
395
|
|
|
354
|
-
### 4. `everything_file_details`
|
|
396
|
+
### 4. `everything_file_details` - Deep Inspection
|
|
355
397
|
|
|
356
398
|
Get metadata and optional content preview for specific files.
|
|
357
399
|
|
|
@@ -362,7 +404,7 @@ Get metadata and optional content preview for specific files.
|
|
|
362
404
|
|
|
363
405
|
**Returns:** Full metadata (size, dates, permissions, hidden status). Directories: item count and listing. Text files with preview: first N lines of content.
|
|
364
406
|
|
|
365
|
-
### 5. `everything_count_stats`
|
|
407
|
+
### 5. `everything_count_stats` - Quick Analytics
|
|
366
408
|
|
|
367
409
|
Get count and size statistics without listing individual files.
|
|
368
410
|
|
|
@@ -489,7 +531,7 @@ Contributions welcome! Areas for improvement:
|
|
|
489
531
|
|
|
490
532
|
## License
|
|
491
533
|
|
|
492
|
-
MIT
|
|
534
|
+
MIT - see [LICENSE](LICENSE)
|
|
493
535
|
|
|
494
536
|
## Acknowledgments
|
|
495
537
|
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
everything_mcp/__init__.py,sha256=pJfNWwOX6hOIyGkCGXqs_6-qOSJaqdo0i6a0C1je2yI,293
|
|
2
|
+
everything_mcp/__main__.py,sha256=vmT0CZ9tECJGqYncEBFRkZsCA8PtWDPsAxZGhip6fN8,125
|
|
3
|
+
everything_mcp/backend.py,sha256=8PO78L1fjUrB92QIz5Pmq8PwP5IISP0RVfppYzdNELM,16845
|
|
4
|
+
everything_mcp/config.py,sha256=YrZM8me3aBbYwM1qIBvaIPULInCQbbhZ7WginevgzL4,9091
|
|
5
|
+
everything_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
6
|
+
everything_mcp/server.py,sha256=H-KnBZQ7u8ZYqir9mnaoAZlfMHOjdufEuK7ArmDhcwI,28577
|
|
7
|
+
everything_mcp-1.0.3.dist-info/METADATA,sha256=5ZwM3KQw_oNlvanqsDJDp3KVcrcJrMouq5f_IXUQSrg,15424
|
|
8
|
+
everything_mcp-1.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
|
|
9
|
+
everything_mcp-1.0.3.dist-info/entry_points.txt,sha256=uML8cv-F-LLAO48ed5Bb8dvt2vue0zkvOIZLPMxskyo,55
|
|
10
|
+
everything_mcp-1.0.3.dist-info/licenses/LICENSE,sha256=lOzySWZ47IwlWsg4jIvVdxDpca_vVry3jnR_Ibqes4g,1064
|
|
11
|
+
everything_mcp-1.0.3.dist-info/RECORD,,
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
everything_mcp/__init__.py,sha256=tVwJJ4VmkLaIhgWa8-O416AXyfzm3t1nsHuOAccqZVE,282
|
|
2
|
-
everything_mcp/__main__.py,sha256=vmT0CZ9tECJGqYncEBFRkZsCA8PtWDPsAxZGhip6fN8,125
|
|
3
|
-
everything_mcp/backend.py,sha256=Dr1EYRu1xZG0Mlwp_m4NeLti1ICG-xY87DZAEhK03uQ,16394
|
|
4
|
-
everything_mcp/config.py,sha256=kb4mnPhqk0vAbrDwwrS1DEaA1LIyiuVhagt1lxFzRhE,8840
|
|
5
|
-
everything_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
6
|
-
everything_mcp/server.py,sha256=Vx2wIj77vfVrAoYhBPVaxTu7CJvbclixguNAn-lsiPk,27850
|
|
7
|
-
everything_mcp-1.0.1.dist-info/METADATA,sha256=vOXCr0pqU1iauE03hZB_pTl7tDOlmSF3kbYOOL-lMuc,14344
|
|
8
|
-
everything_mcp-1.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
|
|
9
|
-
everything_mcp-1.0.1.dist-info/entry_points.txt,sha256=uML8cv-F-LLAO48ed5Bb8dvt2vue0zkvOIZLPMxskyo,55
|
|
10
|
-
everything_mcp-1.0.1.dist-info/licenses/LICENSE,sha256=c6FS4K8gERQWxn6ykdwXZKCYhUV3_Av3Qx1oguEyzZU,1061
|
|
11
|
-
everything_mcp-1.0.1.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|