Filesystem
Filesystem — эталонный MCP-сервер из репозитория modelcontextprotocol/servers. Эталонный сервер для работы с локальной файловой системой с настраиваемым списком разрешённых папок. Лицензия NOASSERTION.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- modelcontextprotocol
- Лицензия
- NOASSERTION
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
В обычном режиме ассистент создаёт, перезаписывает и перемещает файлы в разрешённых папках. Для чтения используйте `--read-only`.
Настройка клиентов
{
"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.
{
"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.
puter
Работа с Puter: управление файлами, сайтами, воркерами и другими ресурсами.
filesystem
Сервер из UI-TARS-desktop для доступа к файловой системе.
Handsy AI
Управление настоящим iPhone через USB HID на ESP32-S3 и AirPlay без джейлбрейка.