Filesystem MCP: Документация

Подключение

npx -y @modelcontextprotocol/server-filesystem /path/allowed1 /path/allowed2 (stdio). Доступ строго внутри перечисленных директорий. Клиенты с поддержкой Roots-протокола могут менять список разрешённых папок динамически, без аргументов командной строки.

Инструменты

• read_text_file / read_media_file / read_multiple_files — чтение текста, медиа (base64) и нескольких файлов разом.
• write_file — создать или полностью перезаписать файл.
• edit_file — точечная правка по паттерну без перезаписи всего файла.
• create_directory, list_directory, list_directory_with_sizes, directory_tree — работа с каталогами, включая рекурсивное JSON-дерево.
• move_file — переместить или переименовать файл/папку.
• search_files — рекурсивный поиск файлов по паттерну.
• get_file_info — метаданные файла или директории.
• list_allowed_directories — показать, какие директории доступны агенту прямо сейчас.

Сценарий для агента

Работа с локальными проектами и документами там, где нет полноценной среды выполнения.

Ограничения

Без аргументов и без поддержки Roots клиентом сервер не запустится — нужно явно указать хотя бы одну разрешённую директорию.