mcp-everything-search

すべて検索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)。利用可能なオプション:

例:

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

• ファイル/フォルダパス
• ファイルサイズ（バイト単位）
• 最終更新日

検索構文ガイド

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

前提条件

ウィンドウズ

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 を自動的に検索してインストールするには:

uvの使用（推奨）

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

PIPの使用

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

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

構成

ウィンドウズ

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

環境変数:

LinuxとmacOS

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

Claude Desktopでの使用

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

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

デバッグ

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

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

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

Linux/macOS:

Windows (PowerShell):

発達

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

1. MCPインスペクタを実行して変更内容をテストしてください。実行手順についてはデバッグを参照してください。
2. Claudeデスクトップアプリを使ってテストしclaude_desktop_config.json 。claude_desktop_config.json に以下のコードを追加してください。

ライセンス

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

免責事項

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