MCP File Finder Server
by romanshablio
The MCP File Finder Server is a Python-based server that allows you to search for files on your computer by name and retrieve the results in JSON format. It's designed to integrate with tools like Cline in VSCode for easy file searching.
Last updated: N/A
README.md
readme_content = """ MCP File Finder Server
Установка и запуск
1. Склонируйте репозиторий:
```sh
git clone <ваш-репозиторий>
cd <ваш-репозиторий>
```
2. Запустите MCP-сервер:
```sh
python mcp_server.py --port 8080
```
3. Настройте Cline в VSCode:
- Откройте `cline_config.json`
- Скопируйте содержимое в конфигурацию Cline
- Перезапустите Cline
Тестирование
Отправьте GET-запрос для поиска файлов:
curl "http://localhost:8080/search?query=example"
Вы получите JSON-ответ с найденными файлами.
"""
Что мы сделали?
Мы написали сервер MCP на Python. Этот сервер умеет искать файлы в компьютере по названию и возвращать результаты в формате JSON. Мы также сделали так, чтобы результаты поиска сохранялись в файл search_results.json.
Теперь Cline в VSCode может работать с этим сервером, отправлять ему запросы и получать ответы.
⸻
Наш MCP-сервер:
✅ Запускается локально (на вашем компьютере). ✅ Работает по HTTP (как обычный сайт). ✅ Ждет запросы на поиск файлов. ✅ Возвращает результаты в формате JSON.
⸻
Что делает Cline?
Cline — это инструмент для работы с нейросетями и программами в VSCode. Он умеет: • подключаться к MCP-серверам, • отправлять запросы, • получать и отображать ответы.
В нашем случае Cline нужен, чтобы легко взаимодействовать с сервером MCP прямо в VSCode.
⸻
Как это работает шаг за шагом?
1️⃣ Запускаем сервер
python mcp_file_finder.py
Теперь он работает и ждет запросов.
2️⃣ Отправляем запрос (например, через curl)
curl "http://localhost:8080/search?query=test"
Мы говорим серверу: “Найди все файлы, в имени которых есть ‘test’”.
3️⃣ Сервер ищет файлы и отправляет ответ • Сканирует компьютер. • Находит подходящие файлы. • Записывает результат в search_results.json. • Отправляет JSON-ответ.
4️⃣ Cline может использовать этот сервер В VSCode мы можем настроить Cline, чтобы он сам отправлял такие запросы и получал результаты без использования curl.
⸻
Зачем всё это сделано?
💡 Главная идея — автоматизировать поиск файлов с помощью кода. Сервер MCP работает как сервис, к которому можно обращаться из любой программы. Это полезно, если, например, у нас будет интерфейс (GUI) или другой инструмент, который захочет искать файлы.
Теперь этот сервер можно подключить в Cline, чтобы прямо в VSCode искать файлы без командной строки. 🚀