Сервер MCP для поиска файлов

Сервер MCP для поиска файлов

site icon
2025.03.03 0
Python文件搜索开发工具文件管理
file-finder-mcp 是一个基于 Python 的 Model Context Protocol (MCP) 服务器,用于在文件系统中搜索文件路径片段,并以 JSON 格式返回搜索结果。它主要与 VSCode 的 Cline 扩展集成,提供高效的文件搜索功能。
View on GitHub

Overview

基本能力

产品定位

file-finder-mcp 是一个文件搜索服务,旨在帮助开发者在文件系统中快速定位包含特定路径片段的文件。

核心功能

  • 在文件系统中搜索文件路径片段
  • 返回 JSON 格式的搜索结果
  • 与 VSCode 的 Cline 扩展集成
  • 搜索不区分大小写
  • 提供文件大小和创建日期信息

适用场景

  • 在大型项目中快速定位文件
  • 需要频繁搜索文件的开发环境
  • 与 VSCode 集成的开发工作流

工具列表

  • find_files: 搜索文件系统并返回匹配的文件列表

常见问题解答

  • 搜索从当前工作目录开始
  • 结果中的文件大小以字节为单位
  • 创建日期使用 ISO 格式

使用教程

使用依赖

  • Python 3.9 或更高版本
  • Python 包 mcp (通过 pip install mcp 安装)
  • VSCode 安装了 Cline 扩展

安装教程

  1. 克隆仓库: bash git clone https://github.com/kyan9400/file-finder-mcp.git cd file-finder-mcp
  2. 安装 Python 包: bash pip install mcp
  3. 配置 Cline:
  4. 编辑 Cline 配置文件 (如 Windows 下的 C:\Users\<用户名>\AppData\Roaming\Code\User\cline_config.json)
  5. 添加以下配置: json { "mcpServers": { "file-finder-mcp": { "args": ["file_finder_server.py"], "command": "python", "autoApprove": [], "disabled": false } } }

调试方式

  1. 手动启动服务器测试: bash python file_finder_server.py
  2. 在 VSCode 中使用 Cline 测试: text Найдите файлы в файловой системе, содержащие фрагмент "test"
  3. 检查返回的 JSON 结果

许可证

该项目遵循 MIT 开源许可条款。