Filesystem MCP Server

Что умеет сервер

Сервер из репозитория modelcontextprotocol/servers написан на Node.js и опубликован в npm как @modelcontextprotocol/server-filesystem. Он отдаёт агенту набор инструментов для работы с файлами: чтение текстовых файлов (в том числе только первых или последних N строк), чтение изображений и аудио, пакетное чтение нескольких файлов, создание и перемещение файлов и каталогов, поиск по маске, дерево каталога и метаданные файла (размер, время изменения, права).

Отдельно стоит edit_file: он вносит точечные правки по найденному фрагменту, сохраняет отступы и тип перевода строк и умеет режим dryRun, который показывает diff без записи. Разработчики сервера советуют всегда сначала смотреть результат в этом режиме.

Когда использовать

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

Если агент уже умеет работать с файлами сам, как Claude Code, отдельный сервер не нужен. Он полезнее клиентам без такого доступа, например Claude Desktop, где в README приведена готовая конфигурация.

Ограничения и безопасность

Сервер работает только внутри разрешённых каталогов. Их передают аргументами командной строки, и в документации это названо единственным способом, который работает во всех версиях протокола. Механизм Roots, с помощью которого клиент подменяет каталоги на лету, в README помечен как устаревший. Без хотя бы одного каталога сервер не запускается.

Агент видит всё содержимое разрешённых папок и может его менять. write_file перезаписывает существующий файл, move_file и edit_file помечены как потенциально разрушающие, а запись не атомарна: при сбое файл может остаться записанным частично. Поэтому открывайте только то, что не жалко: отдельную папку, а не домашний каталог, и храните копии. В Docker-варианте каталог можно примонтировать с флагом ro, тогда сервер сможет его только читать.

Все инструменты сервера работают только с локальной файловой системой и во внешнюю сеть не ходят. Для запуска через npx нужен Node.js 24 или новее.

Claude Desktop

Добавьте блок в claude_desktop_config.json, подставив свои каталоги. Любое количество путей после имени пакета становится списком разрешённых каталогов.

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

В Windows запускайте npx через cmd /c:

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

Docker

Каталоги монтируются в /projects. Флаг ro делает каталог доступным только для чтения.

{
  "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"
      ]
    }
  }
}

Образ собирается командой:

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

VS Code

Откройте палитру команд (Ctrl + Shift + P), выполните MCP: Open User Configuration или создайте файл .vscode/mcp.json в проекте и добавьте:

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

В Windows замените command на cmd, а в начало args добавьте /c и npx.