FileBrowser MCP

Model Context Protocol-Server für FileBrowser Quantum — eine selbst gehostete Weboberfläche zur Dateiverwaltung mit REST-API.

Features

• Dateioperationen: Dateien und Ordner auflisten, lesen, hochladen, herunterladen und löschen

• Benutzerverwaltung: Benutzer mit granularen Berechtigungen erstellen, aktualisieren und löschen (nur Admin)

• Authentifizierung: Automatische Token-Verwaltung mit Sitzungspersistenz

• Mehrbenutzer: Konfigurierbare Anmeldedaten über Umgebungsvariablen

• Fehlerbehandlung: Klare Fehlermeldungen mit Berücksichtigung von Ratenbegrenzungen

Related MCP server: MCP Local Filesystem Server

Installation

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

# Install dependencies
pip install -r requirements.txt

Konfiguration

Legen Sie Umgebungsvariablen für die Authentifizierung fest:

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

Mit Hermes Agent

Zu ~/.hermes/config.yaml hinzufügen:

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

Mehrbenutzer-Einrichtung

Für verschiedene Benutzer (z. B. Admin vs. eingeschränkt) separate MCP-Instanzen verwenden:

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

Verfügbare Tools

Dateioperationen

Die Berechtigungen werden von FileBrowser verwaltet – wenn einem Benutzer die Berechtigung fehlt, gibt die API einen Fehler zurück.

Benutzerverwaltung

Die Benutzer- und Berechtigungsverwaltung erfolgt über die API von FileBrowser. Der MCP gibt die API-Antworten direkt weiter.

System

Berechtigungsreferenz

FileBrowser verwendet diese Berechtigungsflags:

Ratenbegrenzung

FileBrowser Quantum sperrt Konten nach 8 fehlgeschlagenen Anmeldeversuchen (15 Minuten Abklingzeit). Der MCP behandelt dies elegant mit klaren Fehlermeldungen.

API-Kompatibilität

Getestet mit FileBrowser Quantum v1.5.x. Funktioniert möglicherweise mit anderen Versionen, wird aber nicht garantiert.

Lizenz

MIT