FileBrowser MCP

Сервер протокола Model Context Protocol для FileBrowser Quantum — самостоятельного веб-интерфейса управления файлами с REST API.

Возможности

• Операции с файлами: список, чтение, загрузка, скачивание, удаление файлов и папок

• Управление пользователями: создание, обновление, удаление пользователей с детальными разрешениями (только для администратора)

• Аутентификация: автоматическое управление токенами с сохранением сессии

• Многопользовательский режим: настраиваемые учетные данные через переменные окружения

• Обработка ошибок: понятные сообщения об ошибках с учетом ограничений частоты запросов

Related MCP server: MCP Local Filesystem Server

Установка

# Clone the repository
git clone https://github.com/FrancoMeneses/filebrowser-mcp.git
cd filebrowser-mcp

# Install dependencies
pip install -r requirements.txt

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

Задайте переменные окружения для аутентификации:

export FB_URL="https://your-filebrowser-host:8080"
export FB_USER="your-username"
export FB_PASSWORD="your-password"

С агентом Hermes

Добавьте в ~/.hermes/config.yaml:

mcp_servers:
  filebrowser:
    command: "python3"
    ```yaml
    env:
      FB_URL: "https://your-filebrowser-host"
      FB_USER: "your-username"
      FB_PASSWORD: "your-password"
    ```

Настройка нескольких пользователей

Для разных пользователей (например, администратор и ограниченный пользователь) используйте отдельные экземпляры MCP:

mcp_servers:
  filebrowser-admin:
    command: "python3"
    args: ["/path/to/server.py"]
    env:
      FB_URL: "https://your-filebrowser-host"
      FB_USER: "admin"
      FB_PASSWORD: "***"
    timeout: 30
  filebrowser-user:
    command: "python3"
    args: ["/path/to/server.py"]
    env:
      FB_URL: "https://your-filebrowser-host"
      FB_USER: "restricted-user"
      FB_PASSWORD: "***"
    timeout: 30

Доступные инструменты

Операции с файлами

Разрешения управляются через FileBrowser — если у пользователя нет прав, API возвращает ошибку.

Управление пользователями

Управление пользователями и разрешениями осуществляется через API FileBrowser. MCP передает ответы API напрямую.

Система

Справочник по разрешениям

FileBrowser использует следующие флаги разрешений:

Ограничение частоты запросов

FileBrowser Quantum блокирует учетные записи после 8 неудачных попыток входа (блокировка на 15 минут). MCP обрабатывает это корректно, возвращая понятные сообщения об ошибках.

Совместимость с API

Проверено с FileBrowser Quantum v1.5.x. Может работать с другими версиями, но это не гарантируется.

Лицензия

MIT