README.md

MCP File Finder Server

MCP File Finder Server は、ローカルコンピューター上のファイルを名前で検索し、結果を JSON として返す小規模な Python サービスです。

このプロジェクトは、VS Code の Cline などのツールに接続できる、ローカルで動作する MCP 風のヘルパーとして作成されました。検索リクエスト用の HTTP エンドポイントを公開し、最新の検索結果を search_results.json に保存します。

機能

• ユーザーのコンピューター上でローカルに動作します。
• シンプルな HTTP 検索エンドポイントを公開します。
• クエリに基づいてファイルを検索します。
• 結果を JSON 形式で返します。
• 検索結果を search_results.json に保存します。
• 設定を通じて VS Code の Cline に接続できます。

インストールと実行

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

   git clone <repository-url>
   cd <repository-folder>
   

2. MCP サーバーを起動します。

   python mcp_server.py --port 8080
   

3. VS Code で Cline を設定します。

   • cline_config.json を開きます。
   • 設定を Cline にコピーします。
   • Cline を再起動します。

テスト

GET リクエストを送信します。

curl "http://localhost:8080/search?query=example"

サーバーは、一致するファイルを含む JSON レスポンスを返します。

動作の仕組み

1. サーバーを起動します。
2. curl、ブラウザー、または別のツールを使って検索リクエストを送信します。
3. サーバーがローカルコンピューターをスキャンし、一致するファイル名を探します。
4. 一致した結果は search_results.json に保存されます。
5. レスポンスが JSON として返されます。

目的

主な目的は、ローカルファイル検索を自動化し、外部ツールから利用できるようにすることです。このサーバーは、後から GUI、AI アシスタント、またはシンプルな API を通じたローカルファイル検索を必要とする別のプログラムに接続できます。