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可用工具
文件操作
工具 | 描述 |
| 列出目录中的文件和文件夹 |
| 获取文件/文件夹的元数据 |
| 读取文件内容 |
| 创建或更新文件 |
| 创建新目录 |
| 删除文件或文件夹 |
| 下载文件 |
权限由 FileBrowser 管理——如果用户缺少相应权限,API 将返回错误。
用户管理
工具 | 描述 |
| 列出所有用户 |
| 创建用户并设置作用域和权限 |
| 更新用户权限或作用域 |
| 删除用户 |
用户和权限管理通过 FileBrowser 的 API 完成。MCP 直接透传 API 的响应。
系统
工具 | 描述 |
| 检查 FileBrowser 服务器状态 |
权限参考
FileBrowser 使用以下权限标志:
权限 | 描述 |
| 访问管理面板和用户管理 |
| 访问 REST API |
| 编辑现有文件 |
| 创建新文件和文件夹 |
| 删除文件和文件夹 |
| 下载文件 |
| 创建公共分享链接 |
速率限制
FileBrowser Quantum 在 8 次登录失败后会锁定账户(冷却时间为 15 分钟)。MCP 会以清晰的错误信息优雅地处理此情况。
API 兼容性
已在 FileBrowser Quantum v1.5.x 上测试。其他版本可能可用,但不保证兼容。
许可证
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Browse and manage files in your Moxt AI workspace from any MCP client.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server enabling file operations (list, search, read, rename, move) on Google Drive and OneDrive.21MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides secure access to local file system operations.MIT
- AlicenseNot gradedqualityCmaintenanceA full-featured secure MCP server for local file system operations, with built-in image processing, OCR and media tools.Apache 2.0
- FlicenseNot gradedqualityDmaintenanceA hybrid REST + MCP file server for managing files with large file streaming support, enabling AI agents and web frontends to perform file operations via MCP tools and REST APIs.-