Everything Search MCP Server (PRO)

中文版 | English Version

---

<a name="chinese-version"></a>

🇨🇳 中文版

一款专为 Windows 打造的高性能 Model Context Protocol (MCP) 服务器。本工具利用原生的 Everything SDK，为 AI 模型（如 Claude、GPT、Gemini）提供毫秒级的文件搜索、统计分析及磁盘空间洞察能力。

🚀 核心特性

• 极致速度：基于 Everything64.dll 原生调用，数百万个文件搜索仅需毫秒级响应。
• AI 意图自动引导 (Autopilot)：内置运行时意图拦截与专用工具（如 find_largest_folders），防止 AI 模型在处理大数据量任务时陷入低效的递归扫描。
• 智能环境诊断：主动检测磁盘索引状态，并在驱动器未索引时提供精确的修复引导。
• 完美支持中文：原生解决 Windows 环境下的中文乱码问题，确保路径处理 100% 准确。
• 多客户端适配：安装程序支持自动配置 OpenCode 和 Claude Desktop。

🛠 包含工具

工具名称	功能描述
everything_search	元数据搜索（名称、路径、后缀）。极致速度且精准。
everything_stats	文件分布与大小的深度统计分析。
find_largest_folders	磁盘空间分析专用工具（查找占用空间最大的目录）。
find_most_files	查找包含文件数量最多的目录。
get_engine_status	查看已索引驱动器列表及引擎健康状态。

📦 安装指引 (Windows)

1. 从 Releases 页面下载最新的 mcp-everything-search.zip。
2. 将压缩包解压到您的本地固定目录。
3. 双击运行 install.exe。程序将自动尝试为 OpenCode 和 Claude Desktop 完成配置。
4. 重启您的 AI 客户端。

---

<a name="english-version"></a>

🇺🇸 English Version

A high-performance Model Context Protocol (MCP) server built for Windows. Leveraging the native Everything SDK, it provides AI models (like Claude, GPT, Gemini) with millisecond-speed file searching, statistical analysis, and disk usage insights.

🚀 Key Features

• Ultra-Fast Search: Powered by Everything64.dll, searching millions of files in milliseconds.
• AI-Intent Autopilot: Features runtime intent interception and specialized tools (e.g., find_largest_folders) to prevent AI models from falling into inefficient recursive scans.
• Smart Diagnostics: Proactively monitors indexing status and provides actionable hints for unindexed drives.
• Full Unicode Support: Native resolution for Chinese characters and special symbols on Windows.
• Multi-Client Support: The installer automatically configures OpenCode and Claude Desktop.

🛠 Tools Available

• everything_search: Lightning-fast metadata search.
• everything_stats: Statistical analysis of file distribution.
• find_largest_folders: Dedicated tool for disk usage analysis.
• find_most_files: Locate directories with the highest file counts.
• get_engine_status: Check indexing status and drive coverage.

📦 Installation (Windows Only)

1. Download mcp-everything-search.zip from Releases.
2. Extract to a permanent local directory.
3. Run install.exe. It will automatically configure OpenCode and Claude Desktop.
4. Restart your AI client.

---

👨‍💻 Authors / 作者

• guodaxia9527 - Lead Developer / 首席开发
• Gemini Flash Latest - AI System Architect / AI 架构师

📜 Credits & License / 鸣谢与许可证

• Everything SDK: A product of voidtools (https://www.voidtools.com/).
• License: This project is licensed under the MIT License.

---

Note: This tool requires Windows and may request Administrator privileges (UAC) to access NTFS USN Journals if the Everything service is not running.