JE

josephur/everything-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

49 stars 7 forks 质量 63 趋势 17MIT

Claude Code 的 MCP,允许它使用 HTTP 插件来搜索你的文件系统

概览

一台MCP(模型上下文协议)服务器,通过voidtools的Everything Everything为像Claude Code这样的AI助手提供即时文件搜索功能。 Everything 是一个极其快速的文件搜索引擎,适用于 Windows 平台,能够索引 NTFS 盘上的所有文件和文件夹。这个 MCP 服务器将 Everything 的搜索功能展示为 AI 助手调用的工具,使他们能够在毫秒内找到系统中的文件。 - 安装并运行 Everything - 启用(HTTP Server > Options > Everything > Options >启用 HTTP Server) - 18+ 从克隆的仓库目录中执行以下命令: 这样可以全局注册MCP服务器,所以每个Claude Code项目都能访问。把/path/to/everything-mcp替换成你克隆仓库的实际路径。 - --范围用户 — 所有项目中可用(推荐)- --范围项目 — 仅当前项目中可用 Claude MCP 的 add 命令不支持指令字段。

概述(AI 翻译)

一台MCP(模型上下文协议)服务器,通过voidtools的Everything Everything为像Claude Code这样的AI助手提供即时文件搜索功能。

Everything 是一个极其快速的文件搜索引擎,适用于 Windows 平台,能够索引 NTFS 盘上的所有文件和文件夹。这个 MCP 服务器将 Everything 的搜索功能展示为 AI 助手调用的工具,使他们能够在毫秒内找到系统中的文件。

先修条件

  • Windows 所有设备安装并运行
  • Everything HTTP Server 启用(HTTP服务器> >选项 > HTTP Server >启用 HTTP Server)
  • Node.js 18+

安装

配置

克劳德·科德

从克隆的仓库目录中执行以下命令:

这样会全局注册MCP服务器,这样每个Claude Code项目都能调用。把/path/to/everything-mcp替换成你克隆仓库的实际路径。

瞄准镜选项:

  • --scope user — 所有项目中均可使用(推荐)
  • --scope project — 仅当前项目中可用

为了验证,补充了:

之后要删除它:

CLAUDE.md 说明

claude mcp add 命令不支持 instructions 字段。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Everything MCP Server

An MCP (Model Context Protocol) server that gives AI assistants like Claude Code instant file search capabilities via Everything by voidtools.

Everything is a lightning-fast file search engine for Windows that indexes all files and folders on NTFS drives. This MCP server exposes Everything’s search as a tool that AI assistants can call, enabling them to find files across your system in milliseconds.

Prerequisites

  • Windows with Everything installed and running
  • Everything HTTP Server enabled (Everything > Tools > Options > HTTP Server > Enable HTTP Server)
  • Node.js 18+

Installation

git clone https://github.com/Josephur/everything-mcp.git
cd everything-mcp
npm install
npm run build

Configuration

Claude Code

Run this command from the cloned repository directory:

claude mcp add --scope user everything-search -- node /path/to/everything-mcp/dist/index.js

This registers the MCP server globally so it’s available in every Claude Code project. Replace /path/to/everything-mcp with the actual path where you cloned the repo.

Scope options:

  • --scope user — available in all projects (recommended)
  • --scope project — only available in the current project

To verify it was added:

claude mcp list

To remove it later:

claude mcp remove --scope user everything-search

CLAUDE.md Instructions

The claude mcp add command doesn’t support an instructions field. To teach Claude how to prioritize this tool, add the following to your global ~/.claude/CLAUDE.md file (create it if it doesn’t exist), make sure to change the port number to the port number your Everything HTTP Plugin is listening on:

## Everything Search (MCP Tool)

This machine has **Everything (voidtools)** running with an HTTP server on port 54321.
The `everything_search` MCP tool is available in every session.

### MANDATORY: Use Everything FIRST
**ALWAYS attempt `everything_search` FIRST for ANY file search** — whether by name,
path, extension, size, date, or content (`content:` prefix). This applies to every
search task, including content searches within a project. Do NOT default to Grep,
Glob, or Bash for initial searches.

### Fallback to other tools (ONLY after Everything fails or is insufficient)
If Everything returns an error (e.g. connection refused), returns no results, or
the query requires features Everything doesn't support, THEN fall back to:
- **Grep** — for complex regex content searches, or if Everything's `content:` returns nothing
- **Glob** — for precise relative-path pattern matching within the current project
在 GitHub 查看完整 README

安装

npx tsc --watch
新手?先看 mcpskill.org 教程 →