Skip to main content
Glama
FileBrowser MCP

FileBrowser MCP

FileBrowser MCP

用于 FileBrowser Quantum 的模型上下文协议服务器——一个自带 REST API 的自托管文件管理 Web 界面。

功能特性

  • 文件操作:列出、读取、上传、下载、删除文件和文件夹

  • 用户管理:创建、更新、删除用户,支持细粒度权限(仅限管理员)

  • 身份验证:自动令牌管理,支持会话持久化

  • 多用户:可通过环境变量配置凭据

  • 错误处理:清晰的错误信息,并具备速率限制感知能力

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 Agent

添加到 ~/.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

可用工具

文件操作

工具

描述

list_files

列出目录中的文件和文件夹

get_file_info

获取文件/文件夹的元数据

read_file

读取文件内容

upload_file

创建或更新文件

create_folder

创建新目录

delete_item

删除文件或文件夹

download_file

下载文件

权限由 FileBrowser 管理——如果用户缺少相应权限,API 将返回错误。

用户管理

工具

描述

list_users

列出所有用户

create_user

创建用户并设置作用域和权限

update_user

更新用户权限或作用域

delete_user

删除用户

用户和权限管理通过 FileBrowser 的 API 完成。MCP 直接透传 API 的响应。

系统

工具

描述

health_check

检查 FileBrowser 服务器状态

权限参考

FileBrowser 使用以下权限标志:

权限

描述

admin

访问管理面板和用户管理

api

访问 REST API

modify

编辑现有文件

create

创建新文件和文件夹

delete

删除文件和文件夹

download

下载文件

share

创建公共分享链接

速率限制

FileBrowser Quantum 在 8 次登录失败后会锁定账户(冷却时间为 15 分钟)。MCP 会以清晰的错误信息优雅地处理此情况。

API 兼容性

已在 FileBrowser Quantum v1.5.x 上测试。其他版本可能可用,但不保证兼容。

许可证

MIT

Related MCP Connectors

Related MCP Servers