すべて検索MCPサーバー

Windows、macOS、Linuxで高速なファイル検索機能を提供するMCPサーバーです。WindowsではEverything SDKを使用します。macOSでは組み込みのmdfindコマンドを使用します。Linuxではlocate / plocateコマンドを使用します。

ツール

検索

システム全体のファイルとフォルダを検索します。検索機能と構文のサポートはプラットフォームによって異なります。

• Windows: Everything SDK の完全な機能 (以下の構文ガイドを参照)

• macOS: Spotlightデータベースを使用した基本的なファイル名とコンテンツの検索

• Linux: locate データベースを使用した基本的なファイル名検索

パラメータ:

• query (必須): 検索クエリ文字列。プラットフォーム固有の注意事項は以下を参照してください。

• max_results (オプション): 返される結果の最大数 (デフォルト: 100、最大: 1000)

• match_path (オプション): ファイル名だけでなくフルパスと一致させる (デフォルト: false)

• match_case （オプション）：大文字と小文字を区別した検索を有効にする（デフォルト：false）

• match_whole_word (オプション): 単語全体のみ一致 (デフォルト: false)

• match_regex (オプション): 正規表現検索を有効にする (デフォルト: false)

• sort_by (オプション): 結果の並び替え順 (デフォルト: 1)。利用可能なオプション:

  - 1: Sort by filename (A to Z)
  - 2: Sort by filename (Z to A)
  - 3: Sort by path (A to Z)
  - 4: Sort by path (Z to A)
  - 5: Sort by size (smallest first)
  - 6: Sort by size (largest first)
  - 7: Sort by extension (A to Z)
  - 8: Sort by extension (Z to A)
  - 11: Sort by creation date (oldest first)
  - 12: Sort by creation date (newest first)
  - 13: Sort by modification date (oldest first)
  - 14: Sort by modification date (newest first)

例:

{
  "query": "*.py",
  "max_results": 50,
  "sort_by": 6
}

{
  "query": "ext:py datemodified:today",
  "max_results": 10
}

回答には以下が含まれます:

• ファイル/フォルダパス

• ファイルサイズ（バイト単位）

• 最終更新日

検索構文ガイド

各プラットフォーム (Windows、macOS、Linux) でサポートされている検索構文の詳細については、 SEARCH_SYNTAX.md を参照してください。

Related MCP server: MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

前提条件

ウィンドウズ

1. Everything検索ユーティリティ:

   • https://www.voidtools.com/からダウンロードしてインストールします。

   • Everythingサービスが実行されていることを確認してください

2. すべてのSDK:

   • https://www.voidtools.com/support/everything/sdk/からダウンロードしてください。

   • SDKファイルをシステム上の場所に抽出します

リナックス

1. locateまたはplocateコマンドをインストールして初期化します。

   • Ubuntu/Debian: sudo apt-get install plocateまたはsudo apt-get install mlocate

   • Fedora: sudo dnf install mlocate

2. インストール後、データベースを更新します。

   • plocateの場合: sudo updatedb

   • mlocateの場合: sudo /etc/cron.daily/mlocate

macOS

追加の設定は必要ありません。サーバーは組み込みのmdfindコマンドを使用します。

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop を自動的に検索してインストールするには:

npx -y @smithery/cli install mcp-server-everything-search --client claude

uvの使用（推奨）

uvを使用する場合、特別なインストールは必要ありません。uvx uvx使用してmcp-server-everything-searchを直接実行します。

PIPの使用

あるいは、pip 経由でmcp-server-everything-searchをインストールすることもできます。

pip install mcp-server-everything-search

インストール後、次のコマンドを使用してスクリプトとして実行できます。

python -m mcp_server_everything_search

構成

ウィンドウズ

サーバーでは Everything SDK DLL が利用可能である必要があります。

環境変数:

EVERYTHING_SDK_PATH=path\to\Everything-SDK\dll\Everything64.dll

LinuxとmacOS

追加の設定は必要ありません。

Claude Desktopでの使用

プラットフォームに応じて、次のいずれかの構成をclaude_desktop_config.jsonに追加します。

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "mcp_server_everything_search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

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

または、pip インストールを使用する場合:

"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "mcp_server_everything_search"]
  }
}

デバッグ

MCPインスペクタを使用してサーバーをデバッグできます。UVXインストールの場合：

npx @modelcontextprotocol/inspector uvx mcp-server-everything-search

または、パッケージを特定のディレクトリにインストールした場合や、そのディレクトリで開発している場合は、次のようにします。

git clone https://github.com/mamertofabian/mcp-everything-search.git
cd mcp-everything-search/src/mcp_server_everything_search
npx @modelcontextprotocol/inspector uv run mcp-server-everything-search

サーバー ログを表示するには:

Linux/macOS:

tail -f ~/.config/Claude/logs/mcp*.log

Windows (PowerShell):

Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait

発達

ローカル開発を行っている場合、変更をテストする方法は 2 つあります。

1. MCPインスペクタを実行して変更内容をテストしてください。実行手順についてはデバッグを参照してください。

2. Claudeデスクトップアプリを使ってテストしclaude_desktop_config.json 。claude_desktop_config.json に以下のコードを追加してください。

"everything-search": {
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/mcp-everything-search/src/mcp_server_everything_search",
    "run",
    "mcp-server-everything-search"
  ],
  "env": {
    "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
  }
}

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

免責事項

このプロジェクトは、voidtools（Everything検索ユーティリティの開発元）と提携、承認、または後援関係にはありません。これは、公開されているEverything SDKを利用する独立したプロジェクトです。