文件搜索服务器

一个集成Everything文件搜索功能的MCP服务器,为Claude Desktop提供快速文件搜索功能。

  • by essovius
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 essovius/mcp-everything-search

使用说明

所有MCP服务器

集成了MCP(模型上下文协议)的服务器 一切 使用Claude Desktop进行文件搜索。立即从Claude搜索整个Windows文件系统。

特性

  • ⚡ 即时搜索 -利用Everything闪电般快速的文件索引
  • 🔍 多种搜索模式 -基本、过滤、正则表达式、基于类型、基于属性
  • 📁 文件夹操作 -在特定路径内搜索,查找空文件夹
  • 📊 统计 -在不列出文件的情况下获取文件计数和总大小
  • 🕐 最近使用的文件 -查找最近修改的文件
  • 📋 重复查找器 -查找同名文件
  • 💾 出口 -将结果保存为txt、csv、json等格式

先决条件

  1. 视窗 -所有东西都只能在Windows上运行
  2. 一切 必须安装并运行
  3. e.exe (Everything命令行)已安装
    • 从以下位置安装:https://github.com/voidtools/es
    • 一定在里面 %LOCALAPPDATA%\Microsoft\WindowsApps

安装

使用uvx(推荐)

uvx mcp-everything-search

使用pip

pip install mcp-everything-search

配置

将此添加到您的Claude Desktop配置文件中:

地点: %APPDATA%\Claude\claude_desktop_config.json

使用uvx

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

使用pip

{
  "mcpServers": {
    "everything-search": {
      "command": "python",
      "args": ["-m", "mcp_everything_search"]
    }
  }
}

Everything 1.5 Alpha用户

如果你使用的是Everything 1.5 alpha,请添加 EVERYTHING_INSTANCE 环境变量:

{
  "mcpServers": {
    "everything-search": {
      "command": "uvx",
      "args": ["mcp-everything-search"],
      "env": {
        "EVERYTHING_INSTANCE": "1.5a"
      }
    }
  }
}

然后 重新启动克劳德桌面.

可用工具

基本搜索

工具 说明
search_files 使用通配符的基本文件搜索(*, ?),排序选项
search_with_filters 仅使用扩展名、大小、路径过滤器、文件/文件夹进行搜索
search_regex 使用正则表达式搜索

专用搜索

工具 说明
search_by_type 按类别搜索:音频、视频、图像、文档、可执行文件、压缩文件、代码
search_folders 仅查找目录
search_recent_files 查找最近修改的文件
search_duplicates 查找同名文件
search_by_attributes 按隐藏、系统、只读、压缩、加密进行筛选
search_empty_folders 查找空目录
search_large_files 查找超过指定大小的文件

公用事业

工具 说明
search_with_details 搜索详细输出(大小、日期)
get_result_count 获取不列出的比赛计数(快速)
get_total_size 获取所有匹配文件的总大小
open_file_location 在资源管理器中打开包含文件夹
get_file_info 获取文件大小、日期和详细信息
export_search_results 导出为txt、csv、json、m3u、m3u8、tsv、efu

查询示例

问克劳德这样的问题:

  • “查找D:\Projects中的所有Python文件”
  • “搜索大于10mb的PDF文件”
  • “查找过去3天内修改的图像”
  • “查找名为config.json的重复文件”
  • “在我的下载文件夹中查找所有视频文件”
  • “搜索与正则表达式匹配的文件 test_.*\.py$"
  • “在D:\Archive中查找空文件夹”
  • “所有MP3文件的总大小是多少?”
  • “此项目中有多少个JavaScript文件?”
  • “在C:\Windows中查找隐藏文件”
  • “将所有日志文件导出到CSV”

排序选项

多种工具支持 sort_by 参数:

  • name, path, size, extension
  • date-modified, date-created, date-accessed
  • 添加 -descending 对于相反顺序(例如。, size-descending)

发展

# Clone the repo
git clone https://github.com/essovius/mcp-everything-search.git
cd mcp-everything-search

# Create virtual environment
python -m venv venv
.\venv\Scripts\activate

# Install in development mode
pip install -e .

# Run the server
python -m mcp_everything_search

许可证

MIT许可证-请参阅 许可证 了解详情。

致谢