MCP File Finder
About
MCP File Finder is an MCP (Model Context Protocol) server that enables searching for files on the filesystem by matching a fragment of the file path. It is intended for developers or any users who need a simple, local HTTP API to locate files on a machine.
Details
- Author
- cavil2015
- Downloads
- 282
- Categories
- Other
Jump to
- Searches files by any fragment of the file path.
- Returns results as JSON with name, full path, size, and creation date.
- Simple HTTP API: one endpoint (/find) with two parameters.
- Lightweight – runs locally with no external services required.
- Open-source and easy to modify.
Install Python 3.8 or later, clone the repository, install dependencies with pip install -r requirements.txt, then run the server with python mcp_server.py. The server starts on http://127.0.0.1:5000. Send GET requests to the /find endpoint with query (file path fragment) and dir (starting directory) parameters.
MCP File Finder
Описание
MCP сервер для поиска файлов по фрагменту пути.
📦 Установка
1. Убедитесь, что установлен Python 3.8+
2. Клонируйте репозиторий:
git clone https://github.com/cavil2015/mcp-file-finder.git cd mcp-file-finder
3. Установите зависимости:
pip install -r requirements.txt
🚀 Запуск сервера
python mcp_server.py
Сервер будет запущен по адресу:
http://127.0.0.1:5000
🔍 Примеры запросов
- Найти все файлы, содержащие "test":
http://127.0.0.1:5000/find?query=test&dir=.
- Пример ответа(json):
[
{
"name": "testfile.txt",
"path": "/home/user/projects/testfile.txt",
"size": 1024,
"created_at": "Tue Mar 11 12:34:56 2025"
}
]
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
