MCP Filesystem Server — это эталонный MCP-сервер на Go, предоставляющий AI-ассистентам безопасный и контролируемый доступ к локальной файловой системе. Он позволяет моделям читать, редактировать, перемещать и искать файлы и папки в строго заданных администратором директориях, исключая возможность выхода за их пределы.
Ключевые особенности:
Всесторонние файловые операции: Сервер реализует полный набор CRUD-действий, включая чтение, запись, копирование, перемещение и удаление как отдельных файлов, так и целых директорий, а также модификацию содержимого через поиск и замену с поддержкой регулярных выражений.
Мощные поисковые инструменты: Позволяет AI-моделям выполнять поиск файлов по паттерну имени (search_files), а также полнотекстовый поиск по содержимому файлов в дереве каталогов (search_within_files), быстро находя нужную информацию.
Строгая модель безопасности: При запуске сервер получает список разрешенных директорий. Все операции проходят валидацию путей, проверку на атаки типа «обход каталога» (path traversal) и безопасное разрешение символических ссылок, что гарантирует изоляцию модели.
Анализ файлов и директорий: Инструмент get_file_info извлекает детальные метаданные, а tree — строит иерархическое JSON-представление структуры папок с настраиваемой глубиной, позволяя AI быстро понять устройство проекта.
Поддержка различных типов файлов: Корректно обрабатывает текстовые, бинарные и графические файлы, определяя MIME-типы и применяя соответствующие лимиты на размер при встраивании контента.
Для кого: Ориентирован на разработчиков, DevOps-инженеров и всех пользователей AI-клиентов (таких как Claude Desktop), кому нужен безопасный способ дать языковой модели доступ к файлам локального проекта для помощи в написании кода, анализе логов или управлении конфигурациями.
Сценарии использования:
AI-помощь в рефакторинге: Разработчик просит Claude: «Найди все вхождения old_function_name в файлах с расширением .ts внутри папки src/ и замени на new_function_name». Сервер выполняет поиск и модификацию в рамках разрешенной директории.
Анализ логов и диагностика: Модель может прочитать несколько огромных файлов логов через read_multiple_files, найти через search_within_files строки с ошибками и представить сводку проблемы пользователю.
Автоматическое создание структуры проекта: AI-ассистент по одной команде пользователя создает набор вложенных папок и конфигурационных файлов со стартовым содержимым, используя create_directory и write_file.
Безопасная песочница для кода: Системный администратор выдает AI-агенту доступ только в папку /tmp/ai-workspace/, гарантируя, что любые его операции по чтению или изменению файлов не затронут остальную систему.
Цены и доступность: Проект с открытым исходным кодом, написан на Go, распространяется бесплатно. Доступен для установки через go install, также предоставляются готовые бинарные файлы и Docker-образ. Является одним из наиболее популярных и зрелых MCP-серверов для работы с файловой системой, не имеет тарифных планов.
