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 许可证发布。