README.md

MCP File Finder Server

MCP File Finder Server 是一个小型 Python 服务，可按名称搜索本地计算机上的文件，并以 JSON 格式返回结果。

该项目最初是一个本地 MCP 风格的辅助工具，可连接到 VS Code 中的 Cline 等工具。它提供一个用于处理搜索请求的 HTTP 端点，并将最新的搜索结果保存到 search_results.json。

功能

• 在用户的计算机上本地运行。
• 提供简单的 HTTP 搜索端点。
• 按查询内容搜索文件。
• 以 JSON 格式返回结果。
• 将搜索结果保存到 search_results.json。
• 可通过配置连接到 VS Code 中的 Cline。

安装与运行

1. 克隆仓库。

   git clone <repository-url>
   cd <repository-folder>
   

2. 启动 MCP 服务。

   python mcp_server.py --port 8080
   

3. 配置 VS Code 中的 Cline。

   • 打开 cline_config.json。
   • 将配置复制到 Cline 中。
   • 重启 Cline。

测试

发送 GET 请求：

curl "http://localhost:8080/search?query=example"

服务器将返回包含匹配文件的 JSON 响应。

工作原理

1. 启动服务器。
2. 通过 curl、浏览器或其他工具发送搜索请求。
3. 服务器扫描本地计算机，查找匹配的文件名。
4. 匹配结果会保存到 search_results.json。
5. 响应以 JSON 格式返回。

用途

其主要目的是自动执行本地文件搜索，并将搜索功能提供给外部工具。之后可以将该服务器连接到 GUI、AI 助手或其他需要通过简单 API 搜索本地文件的程序。