文件搜索集成服务

Everything-MCP是一个将超高速Windows文件搜索引擎Everything集成到MCP协议中的服务,支持通过自然语言在本地系统中进行文件搜索。

  • by chahero
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 chahero/everything-mcp

使用说明

一切MCP

概述

一切MCP 是一个集成的项目 一切 (Voidtools),一个适用于Windows的超快速文件搜索引擎,作为 MCP(模型上下文协议) 服务器。这使得可以通过Claude Desktop、OpenAI ChatGPT等MCP客户端在本地系统上进行自然语言文件搜索。

它使用Node.js/TypeScript构建,可以通过npm轻松安装和运行,而不需要单独安装Python。


特性

特性 描述
everything_search(query) 通过Everything CLI进行超快速文件/文件夹搜索(es.exe)
everything_open(path) 使用默认应用程序打开搜索到的文件/文件夹(仅限Windows)
everything_glob(folder, pattern) 执行基于文件夹的通配符搜索
quick_index_prompt(topic) 根据搜索结果生成摘要提示

先决条件

  1. Node.js安装 (v18或更高版本)

  2. 一切安装

  3. Everything CLI(es.exe)安装


快速开始

使用npx(推荐-无需安装)

npx everything-mcp

这将自动下载并运行最新版本。在MCP客户端中注册它(请参阅下面的设置说明)。

本地开发

# 1. Clone the repository
git clone https://github.com/chahero/everything-mcp.git
cd everything-mcp

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Run the server
npm start

或者在开发模式下:

npm run dev

使用Claude Desktop进行设置

方法1:使用npx(推荐)

  1. 打开Claude桌面配置文件

    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  2. 添加以下配置:

    {
      "mcpServers": {
        "everything-mcp": {
          "command": "npx",
          "args": ["everything-mcp"]
        }
      }
    }
    
  3. 重新启动克劳德桌面

    • 保存配置文件并完全重新启动Claude Desktop。
  4. 验证连接

    • 在Claude Desktop中开始新的对话。您应该在左下角看到连接的“everything mcp”服务器。

方法2:使用本地路径(如果您克隆了存储库)

  1. 打开Claude桌面配置文件

    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  2. 添加以下配置:

    {
      "mcpServers": {
        "everything-mcp": {
          "command": "node",
          "args": ["C:\\path\\to\\everything-mcp\\dist\\index.js"]
        }
      }
    }
    

    替换 C:\\path\\to\\everything-mcp 使用克隆存储库的实际路径。

  3. 重新启动克劳德桌面

    • 保存配置文件并完全重新启动Claude Desktop。
  4. 验证连接

    • 在Claude Desktop中开始新的对话。您应该在左下角看到连接的“everything mcp”服务器。

扩展思路

  • 启用用于REST API集成的Everything HTTP服务器
  • 结合Naver API、Gemini API、OpenAI API构建混合搜索MCP
  • 与RAG(检索增强生成)搜索管道集成

项目结构

everything-mcp/
 ├── src/
 │   └── index.ts                # MCP server main code (TypeScript)
 ├── dist/                       # Compiled JavaScript (generated after build)
 ├── package.json                # npm package configuration
 ├── tsconfig.json               # TypeScript configuration
 ├── README.md                   # Project documentation
 └── .gitignore                  # Git ignore rules

局限性

  • 仅限Windows(仅限于支持Everything的操作系统)
  • es.exe 必须具有管理员权限才能访问管理员索引路径
  • 仅在UTF-8编码环境中保证完整功能

发展信息


许可证

MIT许可证——可自由修改和分发。