FileBrowser MCP

Servidor del Model Context Protocol para FileBrowser Quantum — una interfaz web autohospedada de gestión de archivos con API REST.

Características

• Operaciones de archivos: Listar, leer, subir, descargar y eliminar archivos y carpetas

• Gestión de usuarios: Crear, actualizar y eliminar usuarios con permisos granulares (solo admin)

• Autenticación: Gestión automática de tokens con persistencia de sesión

• Multiusuario: Credenciales configurables mediante variables de entorno

• Gestión de errores: Mensajes de error claros con conocimiento de los límites de peticiones

Related MCP server: MCP Local Filesystem Server

Instalación

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

# Install dependencies
pip install -r requirements.txt

Configuración

Configure las variables de entorno para la autenticación:

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

Con Hermes Agent

Añada lo siguiente a ~/.hermes/config.yaml:

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

Configuración multiusuario

Para diferentes usuarios (p. ej., admin frente a restringido), utilice instancias MCP separadas:

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

Herramientas disponibles

Operaciones de archivos

Los permisos los gestiona FileBrowser: si un usuario no tiene permiso, la API devuelve un error.

Gestión de usuarios

La gestión de usuarios y permisos se realiza a través de la API de FileBrowser. El MCP transmite las respuestas de la API directamente.

Sistema

Referencia de permisos

FileBrowser utiliza los siguientes indicadores de permiso:

Limitación de peticiones

FileBrowser Quantum bloquea las cuentas tras 8 intentos de inicio de sesión fallidos (tiempo de espera de 15 minutos). El MCP gestiona esta situación sin problemas, con mensajes de error claros.

Compatibilidad con la API

Probado con FileBrowser Quantum v1.5.x. Puede funcionar con otras versiones, pero no está garantizado.

Licencia

MIT