FileBrowser MCP
FileBrowser MCP
FileBrowser Quantum 用のModel Context Protocolサーバー — 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.-