File Finder

🚀 ファイル検索 MCP サービス

このサービスは、Python で書かれたモデルコンテキストプロトコル（MCP）サーバーです。VSCode の Cline 拡張機能と統合することができます。このサーバーは、ファイルパスの断片をもとにファイルシステム内でファイルを検索し、結果を JSON 形式で返します。

🚀 クイックスタート

このファイル検索 MCP サービスを使用することで、ファイルパスの断片をもとにファイルシステム内のファイルを簡単に検索できます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• Python で構築された MCP サーバー。
• VSCode の Cline 拡張機能との統合が可能。
• ファイルパスの断片をもとにファイルシステム内でファイルを検索し、JSON 形式で結果を返す。

📦 インストール

システム要件

• Python 3.9 以上
• Python パッケージ mcp（pip install mcp でインストール）
• Cline 拡張機能がインストールされた VSCode

インストール手順

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

   git clone https://github.com/kyan9400/file-finder-mcp.git
   cd file-finder-mcp
   

2. 必要な Python パッケージをインストールします：

   pip install mcp
   

3. Cline の設定ファイルを更新して MCP サーバーを有効にします：

   • Cline 設定ファイルを開くか作成します（例：Windows システムでは C:\Users\<ВашеИмяПользователя>\AppData\Roaming\Code\User\cline_config.json）。
   • 以下の設定を追加します：

     {
       "mcpServers": {
         "file-finder-mcp": {
           "args": ["file_finder_server.py"],
           "command": "python",
           "autoApprove": [],
           "disabled": false
         }
       }
     }
     

💻 使用例

サーバーの起動

手動でサーバーを起動してテストすることができます：

python file_finder_server.py

Cline はツールを使用する際に自動的にサーバーを起動することもできます。

Cline を使用したテスト

1. Cline 拡張機能がインストールされた VSCode を開きます。
2. Cline の画面で以下のクエリを使用してサーバーをテストします：

   查找包含片段 "test" 的文件系统中的文件
   

3. Cline は find_files ツールを呼び出し、JSON 形式で結果が返されます。例えば：

   [
     {
       "file_name": "test_file.txt",
       "path": "D:\\files\\NEW JOB\\file-finder-mcp\\test_file.txt",
       "size": 1234,
       "created": "2025-03-02T13:00:00.000000"
     }
   ]
   

📚 ドキュメント

注意事項

• 検索はサーバーが起動されたカレントワーキングディレクトリから開始されます。
• 検索は大文字と小文字を区別しません。
• ファイルサイズはバイト単位で表示され、作成日は ISO 形式で表示されます。

📄 ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。