Everything MCP Server

Everything MCP Server

Everything のネイティブ SDK を使用して、すぐにファイルを検索できる機能を提供する Model Context Protocol（MCP）サーバーです。このサーバーは、Everything の強力な検索エンジンと AI ツールを統合し、MCP インターフェースを通じてファイルシステムを高速に検索できます。

特長

• 🔍 ファイルを即座に検索：Everything の即時インデックス作成を活用し、ほぼ瞬時にファイルを検索します
• 🎯 高度なフィルタリング：パス、拡張子、サイズ、更新日などで検索します
• 🔄 重複検出：システム内の重複ファイルを検索します
• 📄 コンテンツ検索：ファイルの内容を検索します（Everything のコンテンツインデックス作成が必要です）
• ⚡ 高性能：ネイティブ SDK との統合による直接 API アクセス
• 🛡️ 読み取り専用：安全で、ファイルシステムを変更しないアクセス

提供するツール

1. search_files

正規表現と大文字・小文字の区別を指定できる基本的なファイル検索です。

パラメーター：

• query（string）：ファイル名の検索クエリ
• maxResults（number、optional）：返す結果の最大数（デフォルト：100）
• matchCase（boolean、optional）：大文字と小文字を区別する検索を有効にします
• matchWholeWord（boolean、optional）：単語全体のみに一致させます
• regex（boolean、optional）：正規表現検索を有効にします

2. search_files_advanced

包括的なフィルタリングオプションを備えた高度な検索です。

パラメーター：

• query（string）：ファイル名の検索クエリ
• path（string、optional）：検索対象を特定のパスに限定します
• extension（string、optional）：ファイル拡張子でフィルタリングします（例：'txt'、'pdf'）
• size（string、optional）：ファイルサイズでフィルタリングします（例：'>1mb'、'<100kb'、'1gb..2gb'）
• dateModified（string、optional）：更新日でフィルタリングします（例：'today'、'yesterday'、'thisweek'、'2024'）
• maxResults（number、optional）：返す結果の最大数（デフォルト：100）
• matchCase（boolean、optional）：大文字と小文字を区別する検索を有効にします
• matchWholeWord（boolean、optional）：単語全体のみに一致させます
• regex（boolean、optional）：正規表現検索を有効にします
• sortBy（enum、optional）：フィールドで結果を並べ替えます（name_asc、name_desc、path_asc、path_desc、size_asc、size_desc、date_asc、date_desc）

3. find_duplicates

ファイル名で重複ファイルを検索します。

パラメーター：

• filename（string）：重複を検索するファイル名
• path（string、optional）：検索対象を特定のパスに限定します
• maxResults（number、optional）：返す結果の最大数（デフォルト：50）

4. search_content

ファイル内のテキストコンテンツを検索します。

パラメーター：

• content（string）：ファイル内で検索するテキストコンテンツ
• fileTypes（string、optional）：対象を特定のファイル形式に限定します（例：'txt;doc;pdf'）
• path（string、optional）：検索対象を特定のパスに限定します
• maxResults（number、optional）：返す結果の最大数（デフォルト：50）

前提条件

1. Everything アプリケーション：インストールされ、実行されている必要があります

   • ダウンロード先：https://www.voidtools.com/
   • API にアクセスできるよう、バックグラウンドで実行されていることを確認してください

2. Node.js：ES モジュールをサポートするバージョン 18 以降

3. Windows OS：Everything SDK との互換性のために必要です

インストール

1. リポジトリをクローンします：

git clone https://github.com/peterparker57/everything-mcp-server.git
cd everything-mcp-server

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

設定

MCP 設定ファイルにサーバーを追加します：

{
  "mcpServers": {
    "everything": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["path/to/everything-mcp-server/build/index.js"],
      "disabled": false,
      "env": {},
      "alwaysAllow": [
        "search_files",
        "search_files_advanced",
        "find_duplicates",
        "search_content"
      ]
    }
  }
}

使用例

基本的なファイル検索

Search for: "msbuild.exe"
Options: Case sensitive, max 50 results

フィルターを使った高度な検索

Query: "*.pdf"
Path: "C:\\Documents"
Size: ">1mb"
Date Modified: "thisweek"
Sort: "size_desc"

重複ファイルの検索

Filename: "config.json"
Path: "C:\\Projects" (optional)

コンテンツ検索

Content: "function main"
File Types: "js;ts;py"
Path: "C:\\Code" (optional)

アーキテクチャ

技術スタック

• 言語：TypeScript
• フレームワーク：MCP SDK (@modelcontextprotocol/sdk)
• FFI ライブラリ：koffi（ネイティブ DLL 統合用）
• モジュールシステム：ES モジュール
• 対象：Everything SDK（Windows 用ファイル検索ユーティリティ）

主要コンポーネント

1. メインサーバー（src/index.ts）：コアとなる MCP サーバーの実装
2. Everything SDK：ファイル検索用のネイティブ Windows DLL
3. ビルドシステム：TypeScript を ES モジュールにコンパイルします
4. 設定：ES モジュールに対応した Package.json

開発

ビルド

npm run build

テスト

サーバーを直接起動してテストします：

node build/index.js

プロジェクト構成

everything-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── EverythingSDK/        # Everything native SDK files
│   └── dll/
│       ├── Everything32.dll
│       └── Everything64.dll
├── build/                # Compiled JavaScript output
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

トラブルシューティング

「Everything 検索クライアントが実行されていません」

• Everything アプリケーションを起動してください
• サービスなしのポータブルモードで実行されていないことを確認してください

MCP エラー「Connection closed」

• ビルドディレクトリが存在し、index.js が含まれていることを確認してください
• MCP 設定の Node.js パスを確認してください
• Everything アプリケーションが実行中であることを確認してください

ES モジュールエラー

• package.json に "type": "module" があることを確認してください
• import 文で .js 拡張子が使われていることを確認してください
• koffi がデフォルトエクスポートとしてインポートされていることを確認してください

パフォーマンスに関する注意事項

• Everything はファイルを即座にインデックス化するため、検索はほぼ瞬時に完了します
• コンテンツ検索には、Everything でコンテンツのインデックス作成を有効にする必要があります
• 大量の検索結果は自動的に制限されます（制限はツールごとに設定可能です）
• API に直接アクセスすると、コマンドラインインターフェイスよりも優れたパフォーマンスが得られます

セキュリティに関する考慮事項

• サーバーは Everything を介して、読み取り専用のファイルシステムアクセスを提供します
• ファイルを変更する機能はありません
• Everything 独自のセキュリティ設定とインデックス設定に従います
• コンテンツ検索の対象は、Everything がインデックス化したファイルに限られます

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. Pull Request を作成します

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルを参照してください。

謝辞

• 優れたファイル検索ユーティリティを提供する voidtools の Everything
• MCP フレームワークを提供する Model Context Protocol
• 優れた FFI ライブラリを提供する koffi

関連プロジェクト

• MCP SDK - Model Context Protocol 用 TypeScript SDK
• Everything - このサーバーが連携するファイル検索ユーティリティ

---

注：これは Windows 専用の MCP サーバーで、Everything アプリケーションがインストールされ、実行されている必要があります。クロスプラットフォームのファイル検索ソリューションをお探しの場合は、ほかの MCP サーバーやファイル検索ツールをご検討ください。