Everything File Search

クイックスタート

/plugin marketplace add elis132/everything-mcp
/plugin install everything-mcp@everything-mcp

Claude Code の場合はこれだけです。このプラグインには MCP サーバーと、クエリ構文を教えるスキルが同梱されています。その他のクライアントについては、以下のインストールを参照してください。

これが選ばれる理由

パフォーマンス

es.exe（Everything のリアルタイム NTFS インデックス）と、単純なファイルシステム走査を同じクエリで比較:

• everything-mcp: 平均 220 ミリ秒（5 回実行）
• C:\ の単純な走査: 66,539 ミリ秒
• 約 300 倍高速

@'
import os, subprocess, time, statistics

ES = os.path.expandvars(r"%LOCALAPPDATA%\Everything\es.exe")
QUERY = "everything.exe"

es_runs = []
for _ in range(5):
    t0 = time.perf_counter()
    subprocess.run([ES, "-n", "100", QUERY], capture_output=True, text=True)
    es_runs.append((time.perf_counter() - t0) * 1000)

t0 = time.perf_counter()
matches = []
for dirpath, _, filenames in os.walk(r"C:\\"):
    for name in filenames:
        if name.lower() == QUERY:
            matches.append(os.path.join(dirpath, name))
walk_ms = (time.perf_counter() - t0) * 1000

es_avg = statistics.mean(es_runs)
print("ES avg ms:", round(es_avg, 2))
print("Walk ms:", round(walk_ms, 2))
print("Speedup x:", round(walk_ms / es_avg, 1))
print("Matches:", len(matches))
'@ | python -

インストール

前提条件

1. Everything がインストールされ、実行中の Windows
2. es.exe（Everything のコマンドラインインターフェース） - Everything 1.5 alpha に同梱されています。または個別にインストールします:
   • winget install voidtools.Everything.Cli
   • scoop install everything-cli
   • choco install es
   • または github.com/voidtools/es からダウンロードして PATH に配置します
3. Python 3.10+ または uv

サーバーを実行する

uvx everything-mcp          # recommended, no install needed
pip install everything-mcp  # or via pip

ソースから:

git clone https://github.com/elis132/everything-mcp.git
cd everything-mcp && pip install -e ".[dev]"

クライアントに追加する

以下のすべてのクライアントは、同じ MCP サーバー定義を使用します:

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

{ "mcpServers": { "everything": { "command": "everything-mcp" } } }

Everything MCP はセットアップを自動検出しますが、上書きすることもできます:

Everything で名前付きインスタンスを明示的に構成した場合にのみ EVERYTHING_INSTANCE を設定してください（ツール → オプション → 全般 → インスタンス）。ほとんどのインストール - ほとんどの Everything 1.5 のインストールを含む - は デフォルト インスタンスで動作します。 これを不必要に設定すると接続が壊れます。迷ったら設定しないでください。

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

ツール

1. everything_search - 主力ツール

クエリ構文:

*.py                          all Python files
ext:py;js;ts                  multiple extensions
ext:py path:C:\Projects       Python files under a path
size:>10mb                    larger than 10 MB
size:1kb..1mb                 between 1 KB and 1 MB
dm:today / dm:last7days       modified today / in the last 7 days
path:D:\Photos dc:2024        created in 2024 (slow function, see below)
"exact name.txt"              exact filename match
project1 | project2           OR search
!node_modules                 exclude a term
ext:py path:C:\proj content:TODO   files containing TODO (slow function, see below)
regex:^test_.*\.py$           regex search
parent:src ext:py             files directly inside 'src' folders
dupe:  /  empty:               duplicate filenames / empty folders

低速な関数。 content:、width:/height:、音楽タグ（artist:、album: など）、そして それらのプロパティがインデックス化されていない場合（Everything > ツール > オプション > インデックス）は dc:、da:、attrib:（および これらのインデックス作成をオフにした場合は dm:/size:）は、Everything にすべての候補ファイルをディスクから読み取らせます - そして Everything はそれが完了するまで他の検索に応答しません。そのため、Everything 1.4 では、サーバーはこれらの条件を最後に実行し、 クエリの残りの部分で候補が十分に絞り込まれた場合にのみ実行します（content: の場合は 1,000 ファイルと 100 MB、画像およびタグ関数の場合は 1,000 ファイル、 日付、属性、サイズの場合は 30,000）。そうでない場合は拒否し、候補数を報告するので、path:、ext:、または名前を追加してください。

2. everything_search_by_type - カテゴリ別検索

カテゴリ: audio、video、image、document、code、archive、executable、font、3d、data

パラメータ: file_type (必須)、query、path、max_results、sort

3. everything_find_recent - 何が変わった？

期間: 1min … 12hours、today、yesterday、1day … 1year

パラメータ: period（デフォルト 1hour）、path、extensions、query、max_results

4. everything_file_details - 詳細な検査

パラメータ: paths (必須、1〜20)、preview_lines（0〜200）

完全なメタデータを返します。ディレクトリの場合はアイテム数と一覧、プレビュー付きのテキストファイルの場合は最初の N 行を返します。

5. everything_count_stats - クイック分析

パラメータ: query (必須)、include_size（デフォルト true）、breakdown_by_extension

すべてのファイルを列挙せずに件数とサイズの統計を取得します - 大きな検索の前に範囲を確認できます。

例

トラブルシューティング

「es.exe not found」 - Everything と es.exe をインストールするか、EVERYTHING_ES_PATH を設定してください。

「Everything IPC window not found」 - Everything が実行中であることを確認してください (システムトレイを確認してください)。EVERYTHING_INSTANCE を設定している場合は、削除してみてください - ほとんどのインストールでは必要ありません。Everything Lite は IPC をサポートしていません。

有効なクエリで結果が返らない - Everything のインデックス構築が完了していることを確認し、Everything の GUI で同じクエリを試し、ドライブ/パスが Everything のインデックス設定に含まれているか確認してください。

デバッグ:

everything-mcp 2>everything-mcp.log                        # server logs
npx @modelcontextprotocol/inspector uvx everything-mcp      # MCP Inspector

開発

pip install -e ".[dev]"   # install with dev dependencies
pytest                    # run tests
ruff check src/ tests/    # lint

コントリビューションを歓迎します - アーキテクチャと設計上の決定については CLAUDE.md を参照してください。関心のある領域: 名前付きパイプによる直接 IPC、1.5 向けの Everything SDK3、コンテンツ検索、ファイル監視、ブックマーク/タグのサポート。

ライセンス

MIT - LICENSE を参照してください

謝辞

Everything を提供する voidtools、Model Context Protocol を提供する Anthropic、そして MCP コミュニティに感謝します。