File Finder

🚀 文件查找 MCP 服務

這是一個用 Python 編寫的模型上下文協議（MCP）服務器，可與 VSCode 中的 Cline 擴展集成。該服務器能依據文件路徑片段，在文件系統中搜索文件，並以 JSON 格式返回搜索結果。

🚀 快速開始

本服務器藉助 Python 實現，與 VSCode 的 Cline 擴展協同工作，可依據文件路徑片段查找文件並返回結果。

✨ 主要特性

• 與 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 配置文件（例如：C:\Users\<ВашеИмяПользователя>\AppData\Roaming\Code\User\cline_config.json 在 Windows 系統中）。
   • 添加以下配置：

     {
       "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 許可證發佈。