Everything MCP

基于 Everything 搜索引擎的 MCP (Model Context Protocol) 服务器。让你的 AI 助手（如 Claude、Kiro 等）能够快速搜索本地文件。

前置要求

• Windows 系统（Everything 仅支持 Windows）
• Everything 已安装并正在运行
• uv 已安装（提供 uvx 命令）

MCP 配置

Claude Desktop

编辑 Claude Desktop 配置文件（通常位于 %APPDATA%\Claude\claude_desktop_config.json）：

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

Kiro

在项目根目录或用户目录下创建 .kiro/settings/mcp.json：

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

Cursor

编辑 ~/.cursor/mcp.json：

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

OpenCode

编辑项目根目录下的 opencode.json（或全局配置）：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "everything": {
      "type": "local",
      "command": ["uvx", "everything-search-mcp"],
      "enabled": true
    }
  }
}

VS Code (Copilot)

在 .vscode/settings.json 中添加：

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

提供的工具

get_current_date

获取当前日期（YYYY-MM-DD 格式），方便在日期筛选时使用。

get_everything_info

获取 Everything 的版本、数据库加载状态和管理员权限信息。

search

基础搜索工具，支持以下参数：

complex_search

高级组合搜索，通过 filters 列表组合多种过滤条件。

基础参数：

每个 filter 是一个 {"type": "...", "params": ...} 结构，支持以下类型：

file_filter — 文件属性过滤

{"type": "file_filter", "params": {"with_extensions": [".py"], "with_content": "import"}}

date_filter — 日期过滤

{"type": "date_filter", "params": {"by_date": "modified_date", "in_range": ["2025-01-01", "2025-12-31"]}}

size_filter — 大小过滤

通过 gt（大于）和 lt（小于）设置范围，单位为字节。

{"type": "size_filter", "params": {"gt": 104857600}}

media_filter — 媒体文件过滤

{"type": "media_filter", "params": {"file_type": "video"}}

document_filter — 文档文件过滤

{"type": "document_filter", "params": {"file_type": "pdf"}}

使用示例

配置完成后，你可以直接在 AI 对话中使用自然语言搜索文件：

"帮我找一下桌面上所有的 PDF 文件"

"搜索最近一周修改过的 Python 文件"

"找出所有大于 100MB 的视频文件"

"在 D 盘搜索包含 config 的 yaml 文件"

AI 助手会自动调用对应的 MCP 工具完成搜索。

排序类型参考

开发

git clone https://github.com/miloira/everything-search-mcp.git
cd everything-search-mcp
uv sync

本地测试运行：

uv run everything-search-mcp

License

MIT