使用说明
基本能力
产品定位
Everything Search MCP Server 是一个跨平台的快速文件搜索服务,旨在为用户提供高效的文件和文件夹搜索功能。
核心功能
- 跨平台支持:Windows(使用Everything SDK)、macOS(使用
mdfind命令)、Linux(使用locate/plocate命令) - 强大的搜索功能:支持文件名、路径、大小、修改日期等多种搜索条件
- 灵活的排序选项:支持按文件名、路径、大小、扩展名、创建日期和修改日期等多种排序方式
- 可定制的结果数量:可设置返回结果的最大数量
适用场景
- 快速定位和管理文件
- 跨平台文件搜索需求
- 开发过程中的文件查找
工具列表
- search:搜索文件和文件夹,支持多种搜索参数和排序方式
使用教程
使用依赖
Windows
- 下载并安装Everything搜索工具:https://www.voidtools.com/
- 确保Everything服务正在运行
- 下载Everything SDK:https://www.voidtools.com/support/everything/sdk/
- 将SDK文件解压到系统上的某个位置
Linux
- 安装
locate或plocate命令:- Ubuntu/Debian:
sudo apt-get install plocate或sudo apt-get install mlocate - Fedora:
sudo dnf install mlocate
- Ubuntu/Debian:
- 安装后更新数据库:
- 对于plocate:
sudo updatedb - 对于mlocate:
sudo /etc/cron.daily/mlocate
- 对于plocate:
macOS
无需额外设置,服务使用内置的mdfind命令。
安装教程
通过Smithery安装
npx -y @smithery/cli install mcp-server-everything-search --client claude
使用uv(推荐)
无需特定安装,使用uvx直接运行mcp-server-everything-search。
使用PIP安装
pip install mcp-server-everything-search
安装后,可以运行:
python -m mcp_server_everything_search
调试方式
使用MCP检查器调试
npx @modelcontextprotocol/inspector uvx mcp-server-everything-search
或
git clone https://github.com/mamertofabian/mcp-everything-search.git
cd mcp-everything-search/src/mcp_server_everything_search
npx @modelcontextprotocol/inspector uv run mcp-server-everything-search
查看服务器日志
Linux/macOS:
tail -f ~/.config/Claude/logs/mcp*.log
Windows (PowerShell):
Get-Content -Path "$env:APPDATAClaudelogsmcp*.log" -Tail 20 -Wait
