Everything Search MCP

io.github.EcRal5t由 GitHub 帳號 EcRal5t 發布v0.1.0更新於 Oct 31, 2026

Fast file search on Windows with Everything. Find files, browse folders, and compare sizes.

已驗證STDIO僅桌面檔案與儲存開發者工具

概覽

AI 產生的概覽

讓助理透過 Everything 索引搜尋 Windows 磁碟：依名稱、路徑、類型、大小或日期尋找檔案與資料夾，瀏覽目錄並比較大小。

可以做什麼
  • 依名稱、路徑、類型、大小或日期在已索引磁碟中搜尋檔案與資料夾，支援正規表示式、排序與分頁
  • 列出某個目錄的直接子項，或在指定根路徑下遞迴搜尋
  • 統計符合筆數與總位元組數，或回傳大小、時間戳記、屬性、執行次數等額外中繼資料
  • 一次請求送出最多八筆查詢，並檢查後端連線、Everything 版本、所選執行個體與索引就緒狀態
適用情境
適用於 Windows 上需要讓助理找出本機或已索引磁碟中的檔案與資料夾、追查大型檔案、尋找專案產物，或比較資料夾大小的情境，不必由使用者手動描述目錄結構。
執行需求
Windows（x64、x86、ARM64、ARM），已安裝並執行 Everything 1.4.1+ 或 1.5 Alpha；Node.js v22.0.0 或更新版本；npm 套件以 stdio 在本機執行，通常經由 cmd.exe 以 npx 啟動。選用環境變數可指定自訂執行個體（EVERYTHING_INSTANCE）、Everything HTTP 服務（EVERYTHING_URL 及 EVERYTHING_USERNAME、EVERYTHING_PASSWORD）、結果上限、輸出預算、逾時與 es.exe 路徑。
安裝前請注意
兩個工具都宣告為唯讀，但搜尋結果會把使用者磁碟上的檔案路徑、名稱、大小與時間戳記提供給助理及其模型供應商。若設定 EVERYTHING_URL，憑證透過 EVERYTHING_USERNAME 與 EVERYTHING_PASSWORD 提供，應避免寫入共用設定檔。HTTP 後端支援的排序欄位與中繼資料比本機 IPC 少。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Everything Search MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Everything Search MCP

简体中文

Search Windows files from your AI assistant using Everything.

Find files across indexed drives by name, path, type, size, or date. Browse folders, compare their sizes, and get counts or total file sizes in a single request. Searches use Everything's existing index, with paginated results and optional metadata.

Prerequisites

  • OS: Windows (x64, x86, ARM64, ARM)
  • Node.js: v22.0.0 or newer
  • Everything: Everything 1.4.1+ or 1.5 Alpha installed and running.

The ES helper is included. The server automatically checks the default Everything instance, 1.5a, and 1.5 and connects through local IPC.

Installation & Configuration

On Windows, launch npx through cmd.exe as shown below. Choose your client, add the configuration, then reload its MCP connections. (DeepSeek Harness is the exception: it spawns the command directly, so plain npx works — see its section below.)

[Install in Cursor]

OpenAI Codex

Add to your Codex configuration file (%USERPROFILE%/.codex/config.toml or project-level .codex/config.toml):

toml
[mcp_servers.everything]command = "cmd.exe"args = ["/d", "/c", "npx", "-y", "everything-mcp-server"]

Or add via Codex CLI:

powershell
codex mcp add everything -- cmd.exe /d /c npx -y everything-mcp-server
OpenCode

Add to your project's opencode.json:

json
{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "everything": {      "type": "local",      "command": ["cmd.exe", "/d", "/c", "npx", "-y", "everything-mcp-server"]    }  }}

Or run the OpenCode setup wizard and enter the command above:

powershell
opencode mcp add
DeepSeek Harness

Install the plugin, then restart the profile:

powershell
dsh plugin --profile <profile> add dsh-everything-mcp

Or install straight from this repository:

powershell
dsh plugin --profile <profile> add github:EcRal5t/everything-search-mcp#path:/plugins/dsh-everything-mcp

The tools appear as mcp__everything__search and mcp__everything__status. To wire it by hand instead, add this row to the profile's cordis.patch.yml:

yaml
- insert:    - id: mcp-everything      name: '@deepseek-ai/dsh-mcp-client'      config:        serverName: everything        transport: stdio        command: npx        args: ['-y', 'everything-mcp-server']

DSH spawns commands directly, so no cmd.exe wrapper is needed. See plugins/dsh-everything-mcp for the bundle itself.

Claude Desktop and other MCP clients

Add to your MCP client configuration (e.g. claude_desktop_config.json):

json
{  "mcpServers": {    "everything": {      "command": "cmd.exe",      "args": ["/d", "/c", "npx", "-y", "everything-mcp-server"]    }  }}

VS Code uses servers as the top-level key.

What to ask

After connecting, ask your assistant to use Everything for tasks such as:

  • Locate a missing file: “Find quarterly-report PDFs modified last month across my indexed drives.”
  • Investigate large files: “Show the ten largest log files or archives over 1 GB on C:, including their paths and sizes.”
  • Find project artifacts: “Find folders named node_modules or target under D:/Projects and tell me how many there are.”
  • Compare folder sizes: “Compare the sizes of the folders directly inside D:/Projects.”

Tools

Both tools are read-only.

ToolPurpose
searchFind paths, browse folders, count matches, and retrieve sizes or other indexed metadata.
statusCheck the connection, selected Everything instance, and version.

Connection settings

Default settings cover common local installations. Use EVERYTHING_INSTANCE for a custom instance name. Setting EVERYTHING_URL selects an Everything HTTP service; credentials go in EVERYTHING_USERNAME and EVERYTHING_PASSWORD when needed.

All environment variables
VariableDefaultDescription
EVERYTHING_INSTANCEauto-detectProbes the default instance, 1.5a, and 1.5. Set this for a custom instance; "" selects the default instance.
EVERYTHING_URL""Everything HTTP server URL (e.g. http://127.0.0.1:17603/). When set, uses HTTP transport instead of IPC.
EVERYTHING_USERNAME""Basic auth username for HTTP server.
EVERYTHING_PASSWORD""Basic auth password for HTTP server.
EVERYTHING_MAX_RESULTS1000Row cap for each query and the whole batch (1–1000).
EVERYTHING_OUTPUT_BYTES16384Maximum output size budget per tool call (4096–65536).
EVERYTHING_TIMEOUT_MS15000Query timeout in milliseconds (100–120000).
EVERYTHING_ES_PATHbundledCustom path to es.exe.

CLI & Diagnostics

Test your Everything installation and backend connection:

powershell
npx -y everything-mcp-server doctor

Run queries from the command line:

powershell
npx -y everything-mcp-server search '{"requests": [{"query": "ext:pdf", "count": 5}]}'

Tool reference

Parameters and result format

search

Search, browse directories, count items, and retrieve indexed metadata.

Pass 1–8 queries in the required requests array:

json
{"requests": [{"query": "ext:pdf", "count": 5}]}

Parameters for each query:

ParameterTypeDefaultDescription
querystring""Everything search query (e.g. *.pdf, size:>100mb, ext:ts;js).
rootstringoptionalDirectory to search within (e.g. D:/Projects). Omitted for global search.
recursivebooleantrueWhen root is set: true searches descendants; false lists direct children.
kindstring"any"Filter entry type: "any", "file", or "folder".
regexbooleanfalseTreat query as a regular expression.
countnumber20Maximum rows to return (max 1000). Use 0 to count matches; add kind:"file" and fields:["size"] to get total_size_bytes.
offsetnumber0Zero-based pagination offset.
sortstring"path"Sort field: path, name, size, extension, date_modified, date_created, date_accessed, attributes, run_count.
ascendingbooleantrueSort ascending (true) or descending (false).
fieldsstring[][]Additional columns: size, date_modified, date_created, date_accessed, attributes, run_count.

IPC provides all listed fields and sorts. HTTP sorts by name, path, size, or modified time; it provides size and modified-time fields, with other metadata depending on the service.

Output Format:

Results label columns once, followed by row arrays:

json
{  "results": [    {      "base": "D:/Projects",      "total": 42,      "next_offset": 2,      "columns": ["path", "type", "size_bytes"],      "rows": [        ["src/index.ts", "file", 1024],        ["package.json", "file", 512]      ],      "size_basis": "indexed_logical"    }  ]}

Combine base with relative paths in rows to obtain full file paths. File and folder sizes use logical byte counts from Everything's index.

status

Check backend connectivity, Everything version, selected instance, and index status.

Parameters:

  • verbose (boolean, default false): Include total indexed items and limits.

Local Development

powershell
git clone https://github.com/EcRal5t/everything-search-mcp.gitcd everything-search-mcpnpm installnpm test

To configure an MCP client with a local checkout:

json
{  "mcpServers": {    "everything": {      "command": "node",      "args": ["D:/path/to/everything-search-mcp/src/cli.js"]    }  }}

License

MIT. Bundled es.exe is also MIT licensed by voidtools. See THIRD_PARTY_NOTICES.md.

來源：README.md，提交 8292039

工具

2

everything_status

Check connection status, selected instance, version, and index readiness.

輸入參數verbose

版本歷史

1
  1. v0.1.0最新Oct 31, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分