FileBrowser MCP

Model Context Protocol server for FileBrowser Quantum — a self-hosted file management web interface with REST API.

Features

• File Operations: List, read, upload, download, delete files and folders

• User Management: Create, update, delete users with granular permissions (admin only)

• Authentication: Automatic token management with session persistence

• Multi-User: Configurable credentials via environment variables

• Error Handling: Clear error messages with rate-limit awareness

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

Configuration

Set environment variables for authentication:

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

With Hermes Agent

Add to ~/.hermes/config.yaml:

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

Multi-User Setup

For different users (e.g., admin vs restricted), use separate MCP instances:

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

Available Tools

File Operations

Permissions are managed by FileBrowser — if a user lacks permission, the API returns an error.

User Management

User and permission management is done through FileBrowser's API. The MCP passes through the API responses directly.

System

Permissions Reference

FileBrowser uses these permission flags:

Rate Limiting

FileBrowser Quantum locks accounts after 8 failed login attempts (15-minute cooldown). The MCP handles this gracefully with clear error messages.

API Compatibility

Tested with FileBrowser Quantum v1.5.x. May work with other versions but not guaranteed.

License

MIT