Everything File Search

快速开始

/plugin marketplace add elis132/everything-mcp
/plugin install everything-mcp@everything-mcp

Claude Code 的配置就这些 - 该插件捆绑了 MCP 服务和一套讲解查询语法的 skill。其他客户端请参阅下方的安装。

为什么选这个

性能

es.exe（Everything 的实时 NTFS 索引）与朴素的文件系统遍历对比，同一查询：

• everything-mcp：平均 220 毫秒（5 次运行）
• 朴素遍历 C:\：66,539 毫秒
• 约快 300 倍

@'
import os, subprocess, time, 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 -

安装

前置条件

1. Windows，已安装并正在运行 Everything
2. es.exe（Everything 的命令行界面）- Everything 1.5 alpha 已内置，或单独安装：
   • winget install voidtools.Everything.Cli
   • scoop install everything-cli
   • choco install es
   • 或从 github.com/voidtools/es 下载并放入你的 PATH
3. Python 3.10+ 或 uv

运行服务

uvx everything-mcp          # recommended, no install needed
pip install everything-mcp  # or via pip

从源码运行：

git clone https://github.com/elis132/everything-mcp.git
cd everything-mcp && pip install -e ".[dev]"

添加到你的客户端

以下每个客户端都使用相同的 MCP 服务定义：

{
  "mcpServers": {
    "everything": {
      "command": "uvx",
      "args": ["everything-mcp"]
    }
  }
}

{ "mcpServers": { "everything": { "command": "everything-mcp" } } }

Everything MCP 会自动检测你的设置，但你可以覆盖：

只有在 Everything 中（工具 → 选项 → 常规 → 实例）显式配置了命名实例时， 才设置 EVERYTHING_INSTANCE。大多数安装 - 包括大多数 Everything 1.5 安装 - 都运行在默认实例上； 无必要地设置此项会破坏连接。如有疑问，请勿设置。

{
  "mcpServers": {
    "everything": {
      "command": "uvx",
      "args": ["everything-mcp"],
      "env": { "EVERYTHING_INSTANCE": "1.5a" }
    }
  }
}

工具

1. everything_search - 主力工具

查询语法：

*.py                          all Python files
ext:py;js;ts                  multiple extensions
ext:py path:C:\Projects       Python files under a path
size:>10mb                    larger than 10 MB
size:1kb..1mb                 between 1 KB and 1 MB
dm:today / dm:last7days       modified today / in the last 7 days
path:D:\Photos dc:2024        created in 2024 (slow function, see below)
"exact name.txt"              exact filename match
project1 | project2           OR search
!node_modules                 exclude a term
ext:py path:C:\proj content:TODO   files containing TODO (slow function, see below)
regex:^test_.*\.py$           regex search
parent:src ext:py             files directly inside 'src' folders
dupe:  /  empty:               duplicate filenames / empty folders

慢速函数。 content:、width:/height:、音乐标签（artist:、album: 等），以及 除非其属性已被索引（Everything > 工具 > 选项 > 索引），否则 dc:、da: 和 attrib:（以及 如果你关闭了它们的索引，则 dm:/size:）会使 Everything 从磁盘读取每个候选文件 - 并且在完成之前 Everything 不会响应其他搜索。因此在 Everything 1.4 上，服务会最后运行 这些词条，且仅当查询的其余部分将候选范围缩小到足够程度时（content: 为 1,000 个文件和 100 MB；图像和标签函数为 1,000 个文件；日期、属性和大小为 30,000 个文件）。否则它会拒绝 并报告候选数量，因此请添加 path:、ext: 或名称。

2. everything_search_by_type - 类别搜索

类别：audio、video、image、document、code、archive、executable、font、3d、data

参数：file_type （必填）、query、path、max_results、sort

3. everything_find_recent - 有什么变化？

周期：1min … 12hours、today、yesterday、1day … 1year

参数：period（默认 1hour）、path、extensions、query、max_results

4. everything_file_details - 深度检查

参数：paths （必填，1-20）、preview_lines（0-200）

返回完整元数据；对于目录，返回项目数量和列表；对于带预览的文本文件，返回前 N 行。

5. everything_count_stats - 快速分析

参数：query （必填）、include_size（默认 true）、breakdown_by_extension

无需列出每个文件即可获得数量和大小统计 - 在大搜索之前检查范围。

示例

故障排查

"es.exe not found" - 安装 Everything 和 es.exe，或设置 EVERYTHING_ES。

"Everything IPC not found" - 确保 Everything 正在运行（检查系统托盘）。如果你设置了 EVERYTHING_INSTANCE，尝试移除它 - 大多数安装不需要它。Everything Lite 不支持 IPC。

有效查询没有结果 - 确认 Everything 的索引已完成构建，在 Everything 的 GUI 中尝试相同的查询，并检查驱动器/路径是否包含在 Everything 的索引设置中。

调试

everything-mcp 2>everything-mcp.log                        # server logs
npx @modelcontextprotocol/inspector uvx everything-mcp      # MCP Inspector

开发

pip install -e ".[dev]"   # install with dev dependencies
pytest                    # run tests
ruff check src/ tests/    # lint

欢迎贡献 - 请参阅 CLAUDE.md 了解架构和设计决策。感兴趣的领域：直接命名管道 IPC、Everything SDK3 for 1.5、内容搜索、文件监控、书签/标签支持。

许可证

MIT - 请参阅 LICENSE

致谢

voidtools 提供的 Everything，Anthropic 提供的 Model Context Protocol，以及 MCP 社区。