文件查找 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 配置文件（例如：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 许可证发布。