Файловая система MCP-сервера

Сервер Node.js, реализующий протокол контекста модели (MCP) для операций файловой системы.

Функции

• Чтение/запись файлов

• Создание/список/удаление каталогов

• Переместить файлы/каталоги

• Поиск файлов

• Получить метаданные файла

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

Related MCP server: Readonly Filesystem MCP Server

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 .

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
        "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
        "mcp/filesystem",
        "/projects"
      ]
    }
  }
}

НПХ

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

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

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

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

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

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

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

Докер

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

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--mount", "type=bind,src=${workspaceFolder},dst=/projects/workspace",
          "mcp/filesystem",
          "/projects"
        ]
      }
    }
  }
}

НПХ

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "${workspaceFolder}"
        ]
      }
    }
  }
}

Строить

Сборка Docker:

docker build -t mcp/filesystem -f src/filesystem/Dockerfile .

Лицензия

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