Everything Search MCP について
Everything Search MCPは、Everythingのインデックス検索をAIアシスタントから利用できるようにするMCPサーバーです。Windows上のファイルを探す人向けで、名前、パス、種類、サイズ、日付による検索や、フォルダーの参照とサイズ集計に対応します。
主な機能
- 01名前、パス、属性による検索
- 02ページ分割でのフォルダー参照
- 03一致件数と合計サイズの集計
- 04フォルダーサイズの比較
- 05Everythingの接続とバージョン確認
活用シーン
- 01指定期間に更新されたPDFの検索
- 02大きなログやアーカイブの特定
- 03プロジェクト内の指定フォルダーの件数確認
- 04複数フォルダーのサイズ比較
MCP 対応
MCPサーバーとして、Everythingのインデックス検索と接続状態の確認に使える読み取り専用の`search`、`status`ツールをクライアントに公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
2掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| requests | array | はい | クエリは 1~8 件、結果順です。 |
詳細
Everything Search MCP
Everything を使って、AI アシスタントから Windows のファイルを検索します。
インデックス化されたドライブ全体から、名前、パス、種類、サイズ、日付でファイルを検索できます。フォルダーを参照してサイズを比較し、1 回のリクエストで件数やファイルサイズの合計を取得できます。検索には Everything の既存のインデックスを使用し、ページ分割された結果と任意のメタデータを利用できます。
前提条件
- OS:Windows(x64、x86、ARM64、ARM)
- Node.js:v22.0.0 以降
- Everything:Everything 1.4.1+ または 1.5 Alpha がインストールされ、実行されていること。
ES ヘルパーは同梱されています。サーバーは既定の Everything インスタンス、1.5a、1.5 を自動的に確認し、ローカル IPC 経由で接続します。
インストールと設定
Windows では、以下のように cmd.exe 経由で npx を起動してください。クライアントを選び、設定を追加してから、MCP 接続を再読み込みします。(DeepSeek Harness はコマンドを直接起動する例外であるため、通常の npx を使用できます。詳しくは以下のセクションをご覧ください。)
OpenAI Codex
Codex の設定ファイル(%USERPROFILE%/.codex/config.toml またはプロジェクトレベルの .codex/config.toml)に追加します。
[mcp_servers.everything]
command = "cmd.exe"
args = ["/d", "/c", "npx", "-y", "everything-mcp-server"]
または、Codex CLI から追加します。
codex mcp add everything -- cmd.exe /d /c npx -y everything-mcp-server
OpenCode
プロジェクトの opencode.json に追加します。
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"everything": {
"type": "local",
"command": ["cmd.exe", "/d", "/c", "npx", "-y", "everything-mcp-server"]
}
}
}
または、OpenCode のセットアップウィザードを実行し、上記のコマンドを入力します。
opencode mcp add
DeepSeek Harness
プラグインをインストールしてから、プロファイルを再起動します。
dsh plugin --profile <profile> add dsh-everything-mcp
または、このリポジトリから直接インストールします。
dsh plugin --profile <profile> add github:EcRal5t/everything-search-mcp#path:/plugins/dsh-everything-mcp
ツールは mcp__everything__search と mcp__everything__status として表示されます。代わりに手動で接続するには、プロファイルの cordis.patch.yml にこの行を追加します。
- insert:
- id: mcp-everything
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: everything
transport: stdio
command: npx
args: ['-y', 'everything-mcp-server']
DSH はコマンドを直接起動するため、cmd.exe のラッパーは必要ありません。バンドル本体については、plugins/dsh-everything-mcp をご覧ください。
Claude Desktop とその他の MCP クライアント
MCP クライアントの設定(例:claude_desktop_config.json)に追加します。
{
"mcpServers": {
"everything": {
"command": "cmd.exe",
"args": ["/d", "/c", "npx", "-y", "everything-mcp-server"]
}
}
}
VS Code ではトップレベルキーとして servers を使用します。
依頼できること
接続後、次のような作業で Everything を使うようアシスタントに依頼できます。
- 見つからないファイルを探す:「インデックス化されたドライブ全体から、先月更新された四半期報告書の PDF を探してください。」
- 大きなファイルを調査する:「C: にある、パスとサイズを含む最大のログファイルまたは 1 GB を超えるアーカイブを 10 件表示してください。」
- プロジェクトの成果物を探す:「D:/Projects の下にある
node_modulesまたはtargetという名前のフォルダーを探し、件数を教えてください。」 - フォルダーのサイズを比較する:「D:/Projects の直下にあるフォルダーのサイズを比較してください。」
ツール
どちらのツールも読み取り専用です。
| ツール | 目的 |
|---|---|
search | パスの検索、フォルダーの参照、一致件数のカウント、サイズやその他のインデックス化されたメタデータの取得を行います。 |
status | 接続、選択された Everything インスタンス、バージョンを確認します。 |
接続設定
デフォルト設定は、一般的なローカルインストールに対応しています。カスタムのインスタンス名を使用する場合は、EVERYTHING_INSTANCE を指定してください。EVERYTHING_URL を設定すると Everything HTTP サービスが選択されます。必要に応じて、認証情報を EVERYTHING_USERNAME と EVERYTHING_PASSWORD に設定してください。
すべての環境変数
| 変数 | デフォルト | 説明 |
|---|---|---|
EVERYTHING_INSTANCE | auto-detect | デフォルトのインスタンス、1.5a、1.5 を順に検出します。カスタムのインスタンスを指定する場合に設定してください。"" を指定するとデフォルトのインスタンスが選択されます。 |
EVERYTHING_URL | "" | Everything HTTP サーバーの URL(例:http://127.0.0.1:17603/)。設定すると、IPC ではなく HTTP トランスポートを使用します。 |
EVERYTHING_USERNAME | "" | HTTP サーバーのベーシック認証ユーザー名。 |
EVERYTHING_PASSWORD | "" | HTTP サーバーのベーシック認証パスワード。 |
EVERYTHING_MAX_RESULTS | 1000 | 各クエリおよびバッチ全体の行数上限(1~1000)。 |
EVERYTHING_OUTPUT_BYTES | 16384 | ツール呼び出しごとの最大出力サイズ(4096~65536)。 |
EVERYTHING_TIMEOUT_MS | 15000 | クエリのタイムアウト(ミリ秒、100~120000)。 |
EVERYTHING_ES_PATH | bundled | es.exe のカスタムパス。 |
CLI と診断
Everything のインストールとバックエンドへの接続をテストします。
npx -y everything-mcp-server doctor
コマンドラインからクエリを実行します。
npx -y everything-mcp-server search '{"requests": [{"query": "ext:pdf", "count": 5}]}'
ツールリファレンス
パラメーターと結果形式
search
検索、ディレクトリの参照、項目数のカウント、インデックス付きメタデータの取得を行います。
必須の requests 配列に、1~8 個のクエリを渡します。
{"requests": [{"query": "ext:pdf", "count": 5}]}
各クエリのパラメーター:
| パラメーター | 型 | デフォルト | 説明 |
|---|---|---|---|
query | string | "" | Everything の検索クエリ(例:*.pdf、size:>100mb、ext:ts;js)。 |
root | string | optional | 検索対象のディレクトリ(例:D:/Projects)。省略すると全体を検索します。 |
recursive | boolean | true | root を指定した場合、true は子孫ディレクトリを検索し、false は直下の項目を一覧表示します。 |
kind | string | "any" | 項目の種類で絞り込みます:"any"、"file"、または "folder"。 |
regex | boolean | false | query を正規表現として扱います。 |
count | number | 20 | 返す行の最大数(最大 1000)。一致数をカウントするには 0 を指定します。一致項目の合計サイズを total_size_bytes として取得するには、kind:"file" と fields:["size"] を追加します。 |
offset | number | 0 | 0 始まりのページネーションオフセット。 |
sort | string | "path" | ソート項目:path、name、size、extension、date_modified、date_created、date_accessed、attributes、run_count。 |
ascending | boolean | true | 昇順(true)または降順(false)でソートします。 |
fields | string[] | [] | 追加の列:size、date_modified、date_created、date_accessed、attributes、run_count。 |
IPC では、一覧にあるすべてのフィールドとソートに対応しています。HTTP では、名前、パス、サイズ、または更新日時でソートでき、サイズと更新日時のフィールドが利用できます。その他のメタデータはサービスによって異なります。
出力形式:
結果では、列名が一度だけ表示され、その後に行配列が続きます。
{
"results": [
{
"base": "D:/Projects",
"total": 42,
"next_offset": 2,
"columns": ["path", "type", "size_bytes"],
"rows": [
["src/index.ts", "file", 1024],
["package.json", "file", 512]
],
"size_basis": "indexed_logical"
}
]
}
base と rows 内の相対パスを組み合わせると、ファイルの完全なパスを取得できます。
ファイルとフォルダーのサイズには、Everything のインデックスに基づく論理バイト数が使用されます。
status
バックエンドへの接続、Everything のバージョン、選択されたインスタンス、インデックスの状態を確認します。
パラメーター:
verbose(boolean、デフォルトはfalse):インデックス項目の総数と上限を含めます。
ローカル開発
git clone https://github.com/EcRal5t/everything-search-mcp.git
cd everything-search-mcp
npm install
npm test
ローカルのチェックアウトを使用して MCP クライアントを設定するには:
{
"mcpServers": {
"everything": {
"command": "node",
"args": ["D:/path/to/everything-search-mcp/src/cli.js"]
}
}
}
ライセンス
MIT。バンドルされている es.exe も voidtools による MIT ライセンスです。THIRD_PARTY_NOTICES.md を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。