File Finder

by kyan9400

Not rated

GitHub

About

Provides file search functionality within filesystems, returning detailed metadata for discovered files based on path fragments.

Details

Author: kyan9400
Repository: kyan9400/file-finder-mcp
Categories: Developer Tools, Design, File Management, AI, Search, Knowledge Base, Infrastructure, Frontend

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name File Finder

Command (node, npx, python, etc.) python
Arguments
- Argument 1 file_finder_server.py
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

JSON

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "file finder": {
            "cwd": ".",
            "env": {},
            "args": [
                "file_finder_server.py"
            ],
            "command": "python"
        }
    }
}

Linux

{
    "cwd": ".",
    "env": [],
    "args": [
        "file_finder_server.py"
    ],
    "command": "python"
}

Macos

{
    "cwd": ".",
    "env": [],
    "args": [
        "file_finder_server.py"
    ],
    "command": "python"
}

Windows

{
    "cwd": ".",
    "env": [],
    "args": [
        "file_finder_server.py"
    ],
    "command": "python"
}

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

Это сервер Model Context Protocol (MCP), написанный на Python, который интегрируется с Cline в VSCode. Он ищет файлы в файловой системе по фрагменту пути и возвращает результаты в формате JSON.

Требования

- Python 3.9 или выше
- Пакет Python mcp (установить с помощью pip install mcp)
- VSCode с установленным расширением Cline

Установка

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. Откройте VSCode с активным расширением Cline.
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.

Инструкции по использованию файла README.md 1. Создайте файл README.md: - В VSCode щелкните правой кнопкой мыши в боковой панели Explorer и выберите "Создать новый файл". - Назовите файл README.md и откройте его. 2. Скопируйте содержимое: - Скопируйте приведенное выше содержимое и вставьте его в файл README.md. 3. Сохраните файл: - Сохраните файл README.md, нажав Ctrl+S (или Cmd+S на Mac).

4. Закоммитьте и отправьте изменения в GitHub: - Если вы еще не закоммитили и не отправили изменения, сделайте это сейчас:

bash
git add README.md
git commit -m "Добавлен файл README с инструкциями по установке и использованию"
git push origin main
``

5. Проверьте на GitHub: - Перейдите в ваш репозиторий на GitHub (https://github.com/kyan9400/file-finder-mcp) и убедитесь, что файлREADME.md` отображается и содержит правильное содержимое.

Этот файл README.md предоставляет четкие инструкции для тех, кто хочет настроить, запустить и протестировать ваш сервер MCP. Если у вас есть дополнительные вопросы или требуется дальнейшая настройка, не стесняйтесь обращаться!

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

File Finder

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

Claude Desktop / Cursor

Linux

Macos

Windows

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

Требования

Установка

Запуск сервера

Тестирование с Cline

Примечания

Лицензия

Инструкции по использованию файла README.md

Install

About

Details

Jump to

Setting up with Highlight

Claude Desktop / Cursor

Linux

Macos

Windows

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

Требования

Установка

Запуск сервера

Тестирование с Cline

Примечания

Лицензия

Инструкции по использованию файла README.md

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright