Skip to main content
Glama
FrancoMeneses

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

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • MCP server for the FFmpeg Micro video transcoding API — create, monitor, download transcodes.

  • A MCP server built for developers enabling Git based project management with project and personal…

  • MCP server for interacting with the Supabase platform

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FrancoMeneses/filebrowser-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server