everything-http-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@everything-http-mcp find all PDFs modified in the last 7 days on my D drive"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
everything-http-mcp
把 Everything(voidtools)自带的 HTTP 服务器 变成 AI 可直接调用的文件搜索能力。零依赖 Everything SDK,不需要 Everything64.dll,也不需要 es.exe——只要你已经开启了 Everything 的 HTTP 服务。
仓库:https://github.com/fishOfOUC/everything-http-mcp 本机默认地址:
http://127.0.0.1:80(Everything 便携版,http_server_port=80)
为什么不用现成的 MCP
项目 | 依赖 | 与你的环境 |
mcp-everything-search(Python) |
| 本机没装 SDK,不可直接用 |
内置 | 走 CLI 子进程,绕开 HTTP 服务 | |
SDK / CLI | 同上 |
这些项目全部基于 Everything SDK 或 es.exe,没有一个走 HTTP 接口。而 HTTP 接口恰好是零配置、跨语言、最适合 MCP 的一条路,所以这里单独实现。
Related MCP server: @shxiaj/everything-mcp
Everything HTTP 接口(官方)
文档:https://www.voidtools.com/zh-cn/support/everything/http/
http://localhost/?search=*.pdf&json=1&count=50&path_column=1&size_column=1&date_modified_column=1参数 | 含义 |
| 搜索表达式 |
| 非 0 返回 JSON |
| 返回条数(JSON 模式默认 4294967295,务必显式传) |
| 跳过条数,用于翻页 |
|
|
| 1 升序,0 降序 |
| 全路径匹配 / 区分大小写 / 全字 / 正则 |
| 让 JSON 带上路径、大小、修改时间等字段 |
返回形如:
{
"totalResults": 12818,
"results": [
{ "type": "file", "name": "a.pdf", "path": "D:\\docs", "size": "148000", "date_modified": "133908035387768450" }
]
}注意两个坑,本项目已处理:
date_modified/date_created是 Windows FILETIME(1601 年起的 100ns 刻度),不是 Unix 时间戳。count=0只返回totalResults,适合做「有多少个」的统计而不传输结果。
提供的工具
工具 | 作用 |
| 搜索文件/目录,返回命中总数、完整路径、类型、大小、修改时间,支持分页与排序 |
| 只返回命中数量( |
| 读取单个路径的实时元数据(fs stat),包括创建时间 |
| 在资源管理器里选中并定位文件 |
folder 参数会转换为 Everything 的 path:"..." 过滤,搜索严格限制在目录内。
没启动怎么办:自动拉起
搜不到 HTTP 服务时,MCP 会判断是「Everything 没运行」还是「运行了但 HTTP 服务没开」,前者会直接启动它:
解析
Everything.exe:EVERYTHING_EXE→ 已运行进程的路径 → 开始菜单快捷方式 → App Paths 注册表 → 常见安装目录用
Start-Process -Verb RunAs以管理员权限启动(本机的 Everything 配置了run_as_admin=1,普通权限起不来),Windows 会弹一次 UAC,点「是」即可每 700ms 探测一次:既要 HTTP 端口能应答,也要空查询能返回索引条目数(刚启动时
Everything.db还在加载,只探测端口会搜出 0 条)索引就绪后自动重试刚才那次查询,对调用方无感
失败会冷却 60 秒,避免反复弹 UAC。想关掉自动启动就设 EVERYTHING_AUTO_START=0;机器上普通权限就能起 Everything 的话设 EVERYTHING_AUTO_ELEVATE=0。
环境变量
变量 | 默认值 | 说明 |
|
| 完整地址,优先于 host/port |
|
| 端口 |
| 空 | HTTP 服务器设了账号密码时填写 |
|
| 单次请求超时 |
|
| 设 |
|
| 设 |
|
| 启动后等端口就绪的最长时间 |
| 自动探测 | 指定 |
|
| 进程名,用于判断是否已运行 |
接入客户端
先确认服务在线:浏览器打开 http://127.0.0.1/ 能看到 Everything 页面。
Claude Desktop(%APPDATA%\Claude\claude_desktop_config.json)、Cursor(~/.cursor/mcp.json)、Cherry Studio 等使用 mcpServers 的客户端:
{
"mcpServers": {
"everything": {
"command": "node",
"args": ["C:\\mcp\\everything-http\\src\\server.js"],
"env": { "EVERYTHING_HTTP_URL": "http://127.0.0.1:80" }
}
}
}Claude Code:
claude mcp add everything -- node "C:\mcp\everything-http\src\server.js"VS Code(.vscode/mcp.json,键名是 servers):
{
"servers": {
"everything": {
"type": "stdio",
"command": "node",
"args": ["C:\\mcp\\everything-http\\src\\server.js"]
}
}
}查询语法速查
写法 | 含义 |
| 指定扩展名 |
| 修改时间 |
| 大小筛选 |
| 目录内搜索 |
| 排除 |
| 布尔组合 |
| 正则 |
测试
node test/smoke.mjs # 4 个工具的真实调用
node test/offline.mjs # 服务未启动、空查询等失败场景安全提醒
当前 Everything 的 HTTP 服务器:
监听
0.0.0.0:80(局域网内其他机器可访问)未设置用户名/密码
http_server_allow_file_download=1(任何能访问该端口的人都能下载你索引到的文件)
建议在「工具 → 选项 → HTTP 服务器」里至少设置账号密码,并把绑定地址改为 127.0.0.1;不需要网页下载时取消「允许文件下载」。配置账号后,在本 MCP 的 env 里填 EVERYTHING_HTTP_USERNAME / EVERYTHING_HTTP_PASSWORD。
Available Tools
4 toolseverything_countEverything 结果计数A
只返回匹配数量,不传输文件列表。适合「我电脑上有多少个 PDF」「这个目录里有多少张图」这类问题。
Inputs: query (required), folder.
everything_file_info文件/目录详情A
读取某个路径的实时元数据(大小、创建/修改/访问时间、是否目录)。不经过 Everything 索引,路径不存在也会明确返回。
Inputs: path (required).
everything_reveal在资源管理器中定位A
在 Windows 资源管理器里选中并定位一个文件/目录,方便用户直接查看或双击打开。
Inputs: path (required).
everything_searchEverything 文件搜索A
用 Everything 索引做全盘文件/文件夹搜索,返回匹配总数和结果列表(名称、完整路径、类型、大小、修改时间)。只支持 Everything 查询语法,不是自然语言。
Inputs: query (required), limit, regex, folder, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools cover distinct domains (counting vs. detailed info vs. indexed search vs. UI reveal). The distinction between counting and searching is clear, preventing major overlaps.
All tools consistently follow the naming convention of prefix_action, using the 'everything' namespace across the entire set.
With 4 tools, the set is tightly scoped to the domain of file system discovery using the Everything index. Each tool provides a distinct, valuable capability for this purpose.
The set covers core discovery and information retrieval needs for local files (count, info, indexed search, UI selection). The primary limitation is the strict requirement for Everything query syntax.
Maintenance
Related MCP Connectors
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Reach your own computers from any AI app: files, search, commands, approvals and outage alerts.
Read and search folders on your own computer with explicit consent. Files are never uploaded.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search local files on Windows using the Everything search engine, supporting basic and complex file searches with filters like date, size, media type, and document type.4MIT
- AlicenseAqualityDmaintenanceEnables lightning-fast file searching on Windows using Everything SDK, with tools for search, version check, status, and file info retrieval.47 npmMIT
- AlicenseAqualityCmaintenanceEnables LLM agents to perform instant whole-disk filename searches using Everything's index, supporting native query syntax and pagination.2MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to search local files and folders via the Everything search engine, with support for advanced queries, file metadata, text previews, and service status.6113 npmMIT