evryth-mcp

English | 简体中文

通过 MCP 调用 Windows 本机 Everything 索引，查找文件和目录。提供 12 个搜索及辅助工具，支持路径、扩展名、大小和修改日期筛选，返回完整路径及文件元数据。

安装准备

当前版本仅支持在 Windows 上运行，依赖本机 Everything 和 ES；macOS、Linux 及其他 Unix 类系统暂不支持原生运行。

需安装 Everything、ES 和 uv（提供 uvx），Python 版本要求为 3.11+。通过 PyPI 安装，无需 Git 或克隆仓库。

从 voidtools 下载页安装 Everything，并保持运行。
在同一页面下载 Everything Command-line Interface（ES），解压到固定目录。
将 es.exe 所在目录加入 Windows 用户或系统 PATH，然后重启终端和 MCP 客户端。

Everything 与 ES 是不同组件。如果已安装全局 ES，且客户端能从 PATH 找到它，无需设置 EVERYTHING_ES_PATH。

验证安装：

es -version

MCP 配置

使用 uvx evryth-mcp 从 PyPI 自动安装并启动，无需提前执行 pip install。

适用于使用 mcpServers JSON 格式的客户端：

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

连接后调用 everything_status，确认返回 connected: true。

如果 ES 已在客户端 PATH 中且使用默认 Everything 实例，上面的配置即可，无需添加环境变量。

需要指定 ES 路径或命名实例时，在 everything-es 配置中添加 env：

{
  "mcpServers": {
    "everything-es": {
      "command": "uvx",
      "args": ["evryth-mcp"],
      "env": {
        "EVERYTHING_ES_PATH": "D:\\Tools\\Everything\\es.exe",
        "EVERYTHING_INSTANCE": "Work"
      }
    }
  }
}

EVERYTHING_ES_PATH：替换为实际 es.exe 的绝对路径，不是 Everything.exe 或目录；客户端能从 PATH 找到 ES 时可删除此项。
EVERYTHING_INSTANCE：填写已运行的 Everything 命名实例名称，示例为 Work；使用默认实例时删除此项。它不会自动创建或启动实例。

这两项可独立使用；如果都不需要，删除整个 env。

工具

工具	功能
everything_search	Everything 原生查询、排序和分页
everything_search_exact	完整文件名匹配
everything_search_keywords	全部/任一关键词及排除词
everything_search_wildcard	* 和 ? 通配符
everything_search_regex	正则表达式
everything_search_fuzzy	连续、非连续及无序关键词匹配
everything_search_pinyin	全拼、首字母、中文混输及多音字
everything_search_by_type	文档、图片、视频、音频、代码、压缩包
everything_search_typo	文件名字符相似度匹配
everything_list_directory	直属或递归目录索引项
everything_count	匹配数量
everything_status	版本与 IPC 状态

例如，让客户端“查找包含合同和2025、排除草稿的 PDF”，或“按拼音 niandubaogao 搜索年度报告”。具体参数由客户端工具描述提供。

使用说明

默认搜索 Everything 全部索引，不额外限制目录；未索引的文件不会出现。
没有专门的文件内容搜索或文件修改工具。
拼音和容错按候选分页匹配，单页无结果不代表全盘不存在；容错分数仅在当前页排序。
IPC 不可达时，检查 Everything 是否运行，以及客户端会话和沙箱权限。
终端能执行 ES 而客户端找不到时，先完全重启客户端，使其继承最新 PATH。

ES 官方文档

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

evryth_mcp-0.1.2.tar.gz (59.6 kB view details)

Uploaded Sep 9, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

evryth_mcp-0.1.2-py3-none-any.whl (12.0 kB view details)

Uploaded Sep 9, 2026 Python 3

File details

Details for the file evryth_mcp-0.1.2.tar.gz.

File metadata

Download URL: evryth_mcp-0.1.2.tar.gz
Upload date: Sep 9, 2026
Size: 59.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for evryth_mcp-0.1.2.tar.gz
Algorithm	Hash digest
SHA256	`c04a8b0a2a859eabcd5ce9f411773ab8deca01348cdc0e05c97101e83069c5ae`
MD5	`b3a7d784e6d8581ba67aabd83cc53b6f`
BLAKE2b-256	`0d3222bafde73ebdf828be6531ee1a5488ce0ce59ec771d581a2b9377ef39fdf`

See more details on using hashes here.

Provenance

The following attestation bundles were made for evryth_mcp-0.1.2.tar.gz:

Publisher: publish.yml on dengbojing/everything-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: evryth_mcp-0.1.2.tar.gz
- Subject digest: c04a8b0a2a859eabcd5ce9f411773ab8deca01348cdc0e05c97101e83069c5ae
- Sigstore transparency entry: 2769109149
- Sigstore integration time: Sep 9, 2026
Source repository:
- Permalink: dengbojing/everything-mcp@812ad4569cadfd99aa84ca005cde3461cacb983e
- Branch / Tag: refs/heads/master
- Owner: https://github.com/dengbojing
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@812ad4569cadfd99aa84ca005cde3461cacb983e
- Trigger Event: push

File details

Details for the file evryth_mcp-0.1.2-py3-none-any.whl.

File metadata

Download URL: evryth_mcp-0.1.2-py3-none-any.whl
Upload date: Sep 9, 2026
Size: 12.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for evryth_mcp-0.1.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`0fb5739b77aeaf99a24a6bf1f26873d2c2ec6fa5e0d202f221db93005972253b`
MD5	`b2e0510103672a59b94677d8f1c6756a`
BLAKE2b-256	`62098130624a9bb165ebfdf23f539ddcae4a7cf1766fb01415d4eceb115d0d4f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for evryth_mcp-0.1.2-py3-none-any.whl:

Publisher: publish.yml on dengbojing/everything-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: evryth_mcp-0.1.2-py3-none-any.whl
- Subject digest: 0fb5739b77aeaf99a24a6bf1f26873d2c2ec6fa5e0d202f221db93005972253b
- Sigstore transparency entry: 2769109190
- Sigstore integration time: Sep 9, 2026
Source repository:
- Permalink: dengbojing/everything-mcp@812ad4569cadfd99aa84ca005cde3461cacb983e
- Branch / Tag: refs/heads/master
- Owner: https://github.com/dengbojing
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@812ad4569cadfd99aa84ca005cde3461cacb983e
- Trigger Event: push

Release history Release notifications | RSS feed

This release

0.1.2 This release

Sep 9, 2026 2 files

0.1.1

Sep 8, 2026 2 files

evryth-mcp 0.1.2

evryth-mcp

安装准备

MCP 配置

工具

使用说明

Key dates

1 maintainer

Requires

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed