# fs-mcp-rs

Ограничивает доступ ИИ-агента заданными папками на диске. Сервер написан на Rust, работает через STDIO или HTTP и поддерживает запуск терминальных команд.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Автор: nihmadev
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/nihmadev/fs-mcp-rs
- Обновлён: 2026-08-01
- HTML: https://affpapa.org/nevibecode/mcp/fs-mcp-rs

## Что делает

Сервер `fs-mcp-rs` даёт клиентам протокола MCP набор инструментов для чтения, правки, создания и поиска файлов. Доступ строго ограничен списком каталогов, заданных пользователем через параметры запуска или TOML-файл. Переход по символическим ссылкам выключен, а по умолчанию сервер не предоставляет доступ на запись.

Инструмент собран на Rust в виде отдельного исполняемого файла, поэтому не тянет тяжёлое дерево зависимостей. Для запуска можно использовать `npx` или предварительно скомпилированный бинарник. Реализован поиск по регулярным выражениям с поддержкой `.gitignore`, атомарная перезапись файлов с хешами BLAKE3 и ограничение объёма передаваемых данных.

Терминальная секция опциональна, но требует внимания. Команды через `run_command` исполняются с полными правами текущего пользователя ОС и игнорируют белые списки папок. Без явной конфигурации или аргументов с путями сервер просто не запустится.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add fs-mcp-rs -- npx -y fs-mcp-rs
```

### Codex

**Командой платформы**
```bash
codex mcp add fs-mcp-rs -- npx -y fs-mcp-rs
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fs-mcp-rs": {
            "command": "npx",
            "args": [
                "-y",
                "fs-mcp-rs"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "fs-mcp-rs": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "fs-mcp-rs"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add fs-mcp-rs npx -y fs-mcp-rs
```

## Когда брать
- ограничить доступ агента только рабочей директорией проекта
- искать совпадения в кодовой базе по регулярным выражениям с учётом `.gitignore`
- заблокировать изменения файлов через режим только для чтения
- выполнять команды консоли с контролем времени работы и лимитом вывода

## Примеры запросов агенту
- Найди в директории проекта все вызовы функции connectDatabase
- Покажи содержимое конфигурационного файла, исключая скрытые папки
- Обнови файл манифеста внутри разрешённого рабочего каталога

## Похожие
- [Remote Desktop Commander](https://affpapa.org/nevibecode/mcp/remote-desktop-commander.md) — MCP-сервер · ★ 194
- [agent-fs](https://affpapa.org/nevibecode/skills/agent-fs.md) — скилл · 3300 установок
- [smux](https://affpapa.org/nevibecode/skills/smux.md) — скилл · 2900 установок
- [Filesystem MCP](https://affpapa.org/nevibecode/mcp/filesystem-mcp.md) — MCP-сервер · ★ 26
- [ultrathink](https://affpapa.org/nevibecode/skills/ultrathink.md) — скилл · 1900 установок
- [loops-cli](https://affpapa.org/nevibecode/skills/loops-cli.md) — скилл · 1500 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md