fs-mcp-rs — MCP-сервер для Claude Code: что делает и как установить
Ограничивает доступ ИИ-агента заданными папками на диске. Сервер написан на Rust, работает через STDIO или HTTP и поддерживает запуск терминальных команд.
claude mcp add fs-mcp-rs -- npx -y fs-mcp-rsЧто делает fs-mcp-rs
Сервер fs-mcp-rs даёт клиентам протокола MCP набор инструментов для чтения, правки, создания и поиска файлов. Доступ строго ограничен списком каталогов, заданных пользователем через параметры запуска или TOML-файл. Переход по символическим ссылкам выключен, а по умолчанию сервер не предоставляет доступ на запись.
Инструмент собран на Rust в виде отдельного исполняемого файла, поэтому не тянет тяжёлое дерево зависимостей. Для запуска можно использовать npx или предварительно скомпилированный бинарник. Реализован поиск по регулярным выражениям с поддержкой .gitignore, атомарная перезапись файлов с хешами BLAKE3 и ограничение объёма передаваемых данных.
Терминальная секция опциональна, но требует внимания. Команды через run_command исполняются с полными правами текущего пользователя ОС и игнорируют белые списки папок. Без явной конфигурации или аргументов с путями сервер просто не запустится.
Какие задачи решает
- ограничить доступ агента только рабочей директорией проекта
- искать совпадения в кодовой базе по регулярным выражениям с учётом
.gitignore - заблокировать изменения файлов через режим только для чтения
- выполнять команды консоли с контролем времени работы и лимитом вывода
Примеры запросов агенту
- Найди в директории проекта все вызовы функции connectDatabase
- Покажи содержимое конфигурационного файла, исключая скрытые папки
- Обнови файл манифеста внутри разрешённого рабочего каталога
Как установить fs-mcp-rs
Командой платформы
claude mcp add fs-mcp-rs -- npx -y fs-mcp-rsКомандой платформы
codex mcp add fs-mcp-rs -- npx -y fs-mcp-rsФайл настроек
{
"mcpServers": {
"fs-mcp-rs": {
"command": "npx",
"args": [
"-y",
"fs-mcp-rs"
]
}
}
}Файл настроек
{
"servers": {
"fs-mcp-rs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fs-mcp-rs"
]
}
}
}Командой платформы
gemini mcp add fs-mcp-rs npx -y fs-mcp-rsПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fs-mcp-rs
Как установить fs-mcp-rs в Claude Code?
Выполните команду claude mcp add fs-mcp-rs -- npx -y fs-mcp-rs. Клиент загрузит готовый бинарник под вашу операционную систему через npx.
Что делает fs-mcp-rs?
Он предоставляет агенту безопасные файловые инструменты, удерживая все операции строго внутри белого списка директорий.
Действуют ли ограничения каталогов на команды терминала?
Нет. Если включён блок [terminal], процессы шелла запускаются с правами учётной записи вашей ОС и могут выходить за пределы заданных путей.
