File Search MCP

File Search MCP

Rust で構築された、ファイルシステム内を全文検索するための特化型 Model Context Protocol（MCP）サーバーです。

🔍 概要

File Search MCP は、指定したディレクトリ内のテキストファイルを対象に、強力な全文検索機能を提供するツールです。Tantivy 検索エンジンを使用して、テキストコンテンツを効率的にインデックス化し、検索します。

このプロジェクトは Model Context Protocol（MCP）を実装しており、このプロトコルに対応する AI アシスタントやその他のシステムと連携できます。

✨ 主な機能

• 全文検索：ディレクトリ構造内のテキストファイルからキーワードを検索します
• ファイルコンテンツリーダー：特定のテキストファイルの内容を読み取り、表示します
• スマートなファイル検出：テキストファイルを自動的に識別し、バイナリファイルをスキップします
• MCP 連携：Model Context Protocol に対応するシステムで動作します
• メモリ内インデックス作成：検索処理用に高速な一時インデックスを作成します
• スコアに基づく結果：関連度スコア付きの検索結果を返します

🛠️ 技術スタック

• Rust：パフォーマンス、安全性、並行処理のために使用
• Tantivy：Rust 製の全文検索エンジンライブラリ
• RMCP：Model Context Protocol の Rust 実装
• Tokio：Rust 用の非同期ランタイム

📋 使い方

まず、こちらから Rust sdk をインストールします。

このリポジトリをクローンします。

git clone [email protected]:Kurogoma4D/file-search-mcp.git

以下を MCP 設定に追加します（Cursor、Claude など）。

• command: <path-to-repo>/target/release/file-search-mcp

<path-to-repo> をクローンしたリポジトリのパスに置き換えてください。

🔄 仕組み

1. サーバーは指定したディレクトリ内のテキストファイルをインデックス化し、バイナリファイルを除外します
2. テキストファイルの内容を処理し、メモリ内の Tantivy インデックスに追加します
3. 検索を実行すると、インデックスを検索して一致する項目を取得し、関連度順に並べます
4. ファイルパスと関連度スコアを付けて結果を返します
5. ファイルコンテンツリーダーツールを使うと、パスを指定して任意のテキストファイルの内容を表示できます

🛠️ 利用可能なツール

検索ツール

• 説明：指定したディレクトリ内のテキストファイルからキーワードを検索します
• パラメーター：
  • directory：検索対象のディレクトリへのパス
  • keyword：検索するキーワード

ファイルコンテンツリーダーツール

• 説明：特定のファイルの内容を読み取り、表示します
• パラメーター：
  • file_path：読み取るファイルへのパス

📄 ライセンス

MIT ライセンス

🙏 謝辞

• 全文検索エンジンを提供する Tantivy
• Model Context Protocol の実装を提供する RMCP