Filesystem MCP — MCP-сервер для Claude Code: что делает и установка
Локальный сервер для работы с файлами с контролем директорий, блокировкой секретов и подтверждением опасных правок. Защищает репозиторий от случайных удалений.
claude mcp add --env FS_ALLOWED_DIRS=<FS_ALLOWED_DIRS> --transport stdio filesystem-mcp -- npx -y @j0hanz/filesystem-mcpЧто делает Filesystem MCP
Сервер даёт ассистенту 14 инструментов для чтения, поиска и изменения кода. Доступ ограничен списком папок, которые задаёт пользователь. Файлы .env, приватные ключи и облачные токены скрыты от чтения. При попытке переписать файл командой create или удалить непустую папку сервер запрашивает подтверждение.
Поиск текста внутри файлов выполняется через регулярные выражения RE2 без риска зависания. Инструмент учитывает правила .gitignore и пропускает каталоги вроде node_modules. Правки можно предварительно проверять в виде diff через режим dryRun. Если нужно полностью исключить изменения на диске, флаг --read-only отключает все пишущие функции.
Для запуска требуется среда Node.js версии 24 или выше. Программа работает локально через stdio либо HTTP, не ведёт телеметрию и не отправляет данные во внешнюю сеть.
Какие задачи решает
- ограничить доступ ассистента выбранными каталогами
- заблокировать чтение файлов с паролями и токенами
- найти вхождения текста регулярным выражением RE2
- применить готовый патч в формате unified diff
- сравнить различия между двумя файлами конфигурации
Примеры запросов агенту
- Найди все комментарии TODO в проекте и сгруппируй их по файлам.
- Сравни различия между config.dev.json и config.prod.json.
- Замени getUser на fetchUser во всех файлах .ts, сначала покажи diff.
Как установить Filesystem MCP
Командой платформы
claude mcp add --env FS_ALLOWED_DIRS=<FS_ALLOWED_DIRS> --transport stdio filesystem-mcp -- npx -y @j0hanz/filesystem-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add filesystem-mcp --env FS_ALLOWED_DIRS=<FS_ALLOWED_DIRS> -- npx -y @j0hanz/filesystem-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"filesystem-mcp": {
"command": "npx",
"args": [
"-y",
"@j0hanz/filesystem-mcp"
],
"env": {
"FS_ALLOWED_DIRS": "<FS_ALLOWED_DIRS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"filesystem-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@j0hanz/filesystem-mcp"
],
"env": {
"FS_ALLOWED_DIRS": "<FS_ALLOWED_DIRS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FS_ALLOWED_DIRS=<FS_ALLOWED_DIRS> filesystem-mcp npx -y @j0hanz/filesystem-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Filesystem MCP
Как установить Filesystem MCP в Claude Code?
Выполните команду claude mcp add --env FS_ALLOWED_DIRS=<FS_ALLOWED_DIRS> --transport stdio filesystem-mcp -- npx -y @j0hanz/filesystem-mcp, подставив путь к разрешённым директориям.
Чем Filesystem MCP отличается от официального сервера?
В отличие от базового референсного сервера, этот проект ищет текст внутри файлов через RE2, скрывает секреты вроде .env, поддерживает unified diff через команду patch и предлагает режим --read-only.
Что нужно подготовить перед запуском?
На рабочей машине требуется Node.js версии 24 или выше. Проверить текущую версию можно командой node --version.
