mcp-server-filesystem

MCP-сервер, предоставляющий операции с файловой системой Linux как инструменты для LLM-агентов, созданный с помощью FastMCP. Разработан как легковесный тестовый сервер с минимальными зависимостями для MCP-прокси/каталога mcprack.

Конфигурация

Учетные данные не требуются. Вся конфигурация задается через переменные окружения, которые считываются один раз при запуске:

Все пути, передаваемые инструментам, разрешаются относительно FS_ROOT и отклоняются, если они пытаются выйти за его пределы (через .. или симлинк). Это граница на уровне приложения, а не изолированная среда (без chroot/mount namespace).

Related MCP server: ab_mcp

Инструменты

Только чтение: list_dir, read_file, stat, exists, glob_search.

Изменяющие (требуют FS_READONLY=false): write_file, mkdir, delete, move, copy.

Использование

Рекомендуемый — пакет Debian из репозитория VitexSoftware

sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg -o /usr/share/keyrings/vitexsoftware-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/vitexsoftware-archive-keyring.gpg] http://repo.vitexsoftware.com trixie main backports" \
  | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update
sudo apt install mcp-server-filesystem

Компонент backports обязателен, а не опционален: python3-mcp (зависимость python3-fastmcp) требует python3-jsonschema >= 4.20.0, который новее версии, поставляемой Debian trixie в main — он доступен только в backports. Без него apt install завершится ошибкой неудовлетворенной зависимости для python3-jsonschema.

Это устанавливает python3-fastmcp и mcp-server-filesystem за один шаг.

Альтернатива — pip

pip install -e .
export FS_ROOT=/path/to/sandbox
mcp-server-filesystem

Интеграция с mcprack

Зарегистрируйте этот сервер в mcprack с помощью:

• Команда: mcp-server-filesystem

• Переменные окружения: FS_ROOT=/path/to/sandbox, FS_READONLY=false (если нужна запись)

mcprack запускает его как подпроцесс stdio и проксирует его по HTTP для каждого пользователя.

Разработка

pytest