mcpField
E
Everything Search MCP

Everything Search MCP

ローカル
github.com/EcRal5t検索02 週間前に更新

Everything Search MCP について

Everything Search MCPは、Everythingのインデックス検索をAIアシスタントから利用できるようにするMCPサーバーです。Windows上のファイルを探す人向けで、名前、パス、種類、サイズ、日付による検索や、フォルダーの参照とサイズ集計に対応します。

主な機能

  1. 01名前、パス、属性による検索
  2. 02ページ分割でのフォルダー参照
  3. 03一致件数と合計サイズの集計
  4. 04フォルダーサイズの比較
  5. 05Everythingの接続とバージョン確認

活用シーン

  1. 01指定期間に更新されたPDFの検索
  2. 02大きなログやアーカイブの特定
  3. 03プロジェクト内の指定フォルダーの件数確認
  4. 04複数フォルダーのサイズ比較

MCP 対応

MCPサーバーとして、Everythingのインデックス検索と接続状態の確認に使える読み取り専用の`search`、`status`ツールをクライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"ecral5t-everything-search": {
"command": "npx",
"args": [
"-y",
"everything-mcp-server"
]
}
}
}
起動コマンドnpx -y everything-mcp-server

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmeverything-mcp-server0.1.0

ツール

2

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
requestsarrayはいクエリは 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 を使用できます。詳しくは以下のセクションをご覧ください。)

Cursor にインストール

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_INSTANCEauto-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_RESULTS1000各クエリおよびバッチ全体の行数上限(1~1000)。
EVERYTHING_OUTPUT_BYTES16384ツール呼び出しごとの最大出力サイズ(4096~65536)。
EVERYTHING_TIMEOUT_MS15000クエリのタイムアウト(ミリ秒、100~120000)。
EVERYTHING_ES_PATHbundledes.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}]}

各クエリのパラメーター:

パラメーター型デフォルト説明
querystring""Everything の検索クエリ(例:*.pdf、size:>100mb、ext:ts;js)。
rootstringoptional検索対象のディレクトリ(例:D:/Projects)。省略すると全体を検索します。
recursivebooleantrueroot を指定した場合、true は子孫ディレクトリを検索し、false は直下の項目を一覧表示します。
kindstring"any"項目の種類で絞り込みます:"any"、"file"、または "folder"。
regexbooleanfalsequery を正規表現として扱います。
countnumber20返す行の最大数(最大 1000)。一致数をカウントするには 0 を指定します。一致項目の合計サイズを total_size_bytes として取得するには、kind:"file" と fields:["size"] を追加します。
offsetnumber00 始まりのページネーションオフセット。
sortstring"path"ソート項目:path、name、size、extension、date_modified、date_created、date_accessed、attributes、run_count。
ascendingbooleantrue昇順(true)または降順(false)でソートします。
fieldsstring[][]追加の列: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 を参照してください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。