Filesystem

Filesystem — эталонный MCP-сервер из репозитория modelcontextprotocol/servers. Эталонный сервер для работы с локальной файловой системой с настраиваемым списком разрешённых папок. Лицензия NOASSERTION.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
modelcontextprotocol
Лицензия
NOASSERTION
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

В обычном режиме ассистент создаёт, перезаписывает и перемещает файлы в разрешённых папках. Для чтения используйте `--read-only`.

Настройка клиентов

vscode
{
    "code": "{\n  \"servers\": {\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@modelcontextprotocol/server-filesystem\",\n        \"${workspaceFolder}\"\n      ]\n    }\n  }\n}",
    "file": ".vscode/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Filesystem — эталонный MCP-сервер из официального репозитория modelcontextprotocol/servers для работы с файлами. Он написан на Node.js и опубликован в npm как @modelcontextprotocol/server-filesystem. Сервер даёт ассистенту доступ только к разрешённым папкам, которые вы указываете при запуске.

Группа Инструменты
Чтение read_text_file, read_media_file, read_multiple_files, get_file_info
Запись write_file, append_file, edit_file
Папки create_directory, list_directory, list_directory_with_sizes, directory_tree
Перемещение move_file, copy_file
Поиск search_files
Доступ list_allowed_directories — какие папки разрешены

Сервер работает по stdio с клиентами обеих версий протокола: с новыми (2026-07-28, запрос server/discover) и с клиентами 2025 года (initialize).

Кому подойдёт

  • Тем, кто работает с документами и заметками в Claude Desktop: прочитать, сравнить, переписать файлы в выбранной папке.
  • Разработчикам: доступ ассистента к одному проекту без доступа ко всему диску.
  • Тем, кому нужен просмотр без изменений: режим только для чтения.

Похожие серверы — в категории файлы и документы.

Установка

Сервер запускается через npx или Docker, отдельная установка не нужна. Разрешённые папки передаются аргументами командной строки — README называет этот способ рекомендуемым, потому что он работает с любой версией протокола. Клиенты 2025 года с поддержкой Roots могут заменить список папок во время работы, но этот способ помечен как устаревший. С флагом --confine-roots папки клиента ограничиваются пересечением с папками из командной строки.

Режим только для чтения включается флагом --read-only: сервер регистрирует только инструменты с пометкой readOnlyHint: true, а write_file, edit_file и другие пишущие инструменты клиенту просто не видны. Флаг --read-only-dir делает только для чтения отдельную папку. В Docker все папки по умолчанию монтируются в /projects.

Подключение к клиентам

Конфиги приведены дословно из README. Замените пути на свои папки. Для Windows README предлагает запуск через cmd /c npx. Общий порядок — в инструкции как подключить MCP.

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

Проверка

Спросите ассистента: «Какие папки тебе доступны?» Он вызовет list_allowed_directories. Затем попросите показать дерево одной из папок.

Примеры задач

Найди в папке с договорами все файлы за 2026 год и составь список с датами.
Прочитай README проекта и допиши раздел про установку.

Риски

В обычном режиме ассистент может создавать, перезаписывать, перемещать и править файлы в разрешённых папках. Ошибочная правка или перезапись затронет реальные файлы.

Что встроено: сервер обращается только к разрешённым папкам. Проверка идёт по реальному пути, поэтому символическая ссылка в папке с правом записи не позволит записать в папку только для чтения. Папка, вложенная в папку только для чтения, тоже только для чтения. Корень клиента вне разрешённых папок игнорируется, а если у клиента не осталось допустимых корней, доступ закрывается полностью.

Как снизить риски: разрешайте только нужные папки, а не весь диск, используйте --read-only для задач чтения, держите важные файлы под контролем версий или в резервной копии.

Частые вопросы

Можно ли запретить ассистенту изменять файлы?

Да. Запустите сервер с --read-only — пишущие инструменты не будут зарегистрированы вовсе.

Почему сервер не видит мою папку?

Папка должна быть в списке аргументов при запуске. В Docker её нужно смонтировать в /projects.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • read_text_file
  • read_multiple_files
  • write_file
  • edit_file
  • move_file
  • search_files
  • directory_tree
  • list_allowed_directories

Похожие MCP-серверы

markitdown-mcp

Конвертация файлов разных форматов, локальных и по ссылке, в Markdown для моделей с помощью MarkItDown.

Риск: medium Лицензия: MIT ★ 196 722

puter

Работа с Puter: управление файлами, сайтами, воркерами и другими ресурсами.

Риск: medium Лицензия: AGPL-3.0 ★ 44 148

filesystem

Сервер из UI-TARS-desktop для доступа к файловой системе.

Риск: high Лицензия: Apache-2.0 ★ 39 555

Handsy AI

Управление настоящим iPhone через USB HID на ESP32-S3 и AirPlay без джейлбрейка.

Риск: high Лицензия: MIT ★ 4 888

Источники