mcp-server

mcp-server

1
file_systems

This project provides a basic Model Context Protocol (MCP) server written in Python that enables file searching within a file system. It's designed for integration with VSCode using the Cline extension for ease of use.

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

Это простой MCP-сервер, написанный на Python, который ищет файлы в файловой системе на основе фрагмента пути и возвращает результаты в формате JSON.

Установка

  1. Клонируйте этот репозиторий или загрузите скрипт 'file_finder_mcp.py'.
  2. Убедитесь, что в вашей системе установлен Python 3.x.

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

  1. Откройте терминал и перейдите в каталог, содержащий 'file_finder_mcp.py'.
  2. Запустите сервер с помощью следующей команды:
python file_finder_mcp.py

Описание

Для настройки Cline в VSCode для работы с представленным MCP сервером, выполним следующие шаги. Начнем с установки и настройки всех необходимых компонентов.

Шаг 1: Установка VSCode

У вас установлен VSCode.

Шаг 2: Установка расширения Cline

  1. Откройте VSCode.
  2. Перейдите в раздел расширений (Extensions) через боковую панель или нажмите 'Ctrl+Shift+X'.
  3. В поиске введите Cline.
  4. Найдите расширение Cline и установите его.

Шаг 3: Установка Python

Убедитесь, что на вашем компьютере установлен Python 3.x

Шаг 4: Запуск MCP сервера

Скачайте или создайте файл 'file_finder_mcp.py' (код сервера приведен выше).
Откройте терминал в VSCode (Ctrl+`) или используйте любой другой терминал.
Перейдите в папку, где находится file_finder_mcp.py.
Запустите сервер командой:

python file_finder_mcp.py

Сервер запустится на порту 8080. Вы увидите сообщение:

Starting MCP server on port 8080...

Шаг 5: Настройка Cline для работы с MCP сервером

В VSCode откройте файл конфигурации Cline. Если файла нет, создайте его в папке .vscode вашего проекта:

Путь: '.vscode/cline-config.json'

Добавьте конфигурацию для MCP сервера:

{
  "mcpServers": {
    "file-finder-mcp": {
      "args": [
        "python",
        "file_finder_mcp.py"
      ],
      "command": "python",
      "autoApprove": [],
      "disabled": false
    }
  }
}

Здесь:

  • 'command': Команда для запуска сервера (python).
  • 'args': Аргументы для запуска сервера (файл file_finder_mcp.py).
  • 'autoApprove': Список автоматически одобряемых действий (оставьте пустым).
  • 'disabled': Если false, сервер будет активен. Сохраните файл конфигурации.

Шаг 6: Подключение Cline к MCP серверу

Перезапустите VSCode, чтобы применить изменения в конфигурации.
Убедитесь, что MCP сервер запущен (см. Шаг 4).
В VSCode откройте панель Cline (если она не открыта автоматически).
Cline должен автоматически подключиться к MCP серверу, используя конфигурацию из 'cline-config.json'.

Шаг 7: Пример запроса и ответа

curl "http://localhost:8080/?path=example"

или у вас установлен Postman. Pfgecnbnt 'GET' запрос

http://localhost:8080/?path=readme

[
    {
        "name": "readme.markdown",
        "path": "/AdobePhotoshop\\Adobe\\Adobe Photoshop CC 2019\\Required\\Generator-builtin\\node_modules\\optimist\\readme.markdown",
        "size": 11208,
        "creation_date": "2019-10-17 15:25:58"
    },
    {
        "name": "readme.markdown",
        "path": "/AdobePhotoshop\\Adobe\\Adobe Photoshop CC 2019\\Required\\Generator-builtin\\node_modules\\optimist\\node_modules\\minimist\\readme.markdown",
        "size": 1712,
        "creation_date": "2019-10-17 15:25:58"
    },
    {
        "name": "readme.txt",
        "path": "/AdobePhotoshop\\Adobe\\Adobe Photoshop CC 2019\\Required\\Linguistics\\Providers\\Plugins2\\AdobeHunspellPlugin\\dictionaries\\tr_TR\\readme.txt",
        "size": 362,
        "creation_date": "2019-10-17 15:56:44"
    },
    {
        "name": "readme.md",
        "path": "/AdobePhotoshop\\Adobe\\Adobe Photoshop CC 2019\\Required\\Plug-ins\\Generator\\assets.generate\\node_modules\\os-tmpdir\\readme.md",
        "size": 725,
        "creation_date": "2019-10-17 15:25:58"
    },
]