Skip to main content
Glama
FrancoMeneses

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

利用可能なツール

ファイル操作

ツール

説明

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