Filesystem MCP Server

Файловая система MCP Server [MOD]

Node.js сервер реализует Model Context Protocol (MCP) для операций файловой системы. Это ответвление от https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem

Изменения:

• Автономный, без зависимостей от корневого проекта
• Можно использовать регулярные выражения для определения разрешенного каталога.
• Автоматическое преобразование между прямой косой чертой (/) и обратной косой чертой ()

Функции

• Чтение/запись файлов
• Создание/список/удаление каталогов
• Переместить файлы/каталоги
• Поиск файлов
• Получить метаданные файла

Примечание : сервер разрешит операции только в пределах каталогов, указанных с помощью args .

API

Ресурсы

• file://system : Интерфейс операций файловой системы

Инструменты

• прочитанный_файл
  • Прочитать полное содержимое файла
  • Ввод: path (строка)
  • Считывает полное содержимое файла в кодировке UTF-8
• прочитать_несколько_файлов
  • Чтение нескольких файлов одновременно
  • Ввод: paths (string[])
  • Неудачные чтения не остановят всю операцию.
• запись_файла
  • Создайте новый файл или перезапишите существующий (будьте осторожны)
  • Входные данные:
    • path (строка): Расположение файла
    • content (строка): Содержимое файла
• редактировать_файл
  • Вносите выборочные изменения, используя расширенное сопоставление с образцом и форматирование.
  • Функции:
    • Сопоставление содержимого по строкам и по нескольким строкам
    • Нормализация пробелов с сохранением отступов
    • Несколько одновременных правок с правильным позиционированием
    • Определение и сохранение стиля отступа
    • Вывод различий в стиле Git с контекстом
    • Предварительный просмотр изменений в режиме пробного прогона
  • Входные данные:
    • path (строка): Файл для редактирования
    • edits (массив): Список операций редактирования
      • oldText (строка): Текст для поиска (может быть подстрокой)
      • newText (строка): Текст для замены
    • dryRun (логическое значение): предварительный просмотр изменений без их применения (по умолчанию: false)
  • Возвращает подробную информацию о различиях и соответствиях для пробных прогонов, в противном случае применяет изменения
  • Лучшая практика: всегда сначала используйте dryRun для предварительного просмотра изменений перед их применением.
• создать_каталог
  • Создайте новый каталог или убедитесь, что он существует
  • Ввод: path (строка)
  • При необходимости создает родительские каталоги.
  • Выполняется без уведомления, если каталог существует
• список_каталогов
  • Список содержимого каталога с префиксами [FILE] или [DIR]
  • Ввод: path (строка)
• переместить_файл
  • Перемещать или переименовывать файлы и каталоги
  • Входные данные:
    • source (строка)
    • destination (строка)
  • Не удается, если пункт назначения существует
• поиск_файлов
  • Рекурсивный поиск файлов/каталогов
  • Входные данные:
    • path (строка): Начальный каталог
    • pattern (строка): Шаблон поиска
    • excludePatterns (string[]): Исключить любые шаблоны. Поддерживаются форматы Glob.
  • Сопоставление без учета регистра
  • Возвращает полные пути к совпадениям
• получить_информацию_о_файле
  • Получить подробные метаданные файла/каталога
  • Ввод: path (строка)
  • Возврат:
    • Размер
    • Время создания
    • Измененное время
    • Время доступа
    • Тип (файл/каталог)
    • Разрешения
• список_разрешенных_каталогов
  • Список всех каталогов, к которым серверу разрешен доступ
  • Ввод не требуется
  • Возврат:
    • Каталоги, которые этот сервер может читать/писать

Использование с Claude Desktop

Добавьте это в ваш claude_desktop_config.json :

Примечание: вы можете предоставить изолированные каталоги серверу, смонтировав их в /projects . Добавление флага ro сделает каталог доступным только для чтения сервером.

Докер

Примечание: по умолчанию все каталоги должны быть смонтированы в /projects .

НПХ

Использование с VS Code

Для быстрой установки нажмите кнопки установки ниже...

Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open Settings (JSON) .

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

Обратите внимание, что ключ mcp не нужен в файле .vscode/mcp.json .

Вы можете предоставить изолированные каталоги серверу, смонтировав их в /projects . Добавление флага ro сделает каталог доступным только для чтения сервером.

Докер

Примечание: по умолчанию все каталоги должны быть смонтированы в /projects .

НПХ

Строить

Сборка Docker:

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.