Skip to main content
Glama
FrancoMeneses

FileBrowser MCP

FileBrowser MCP

Model Context Protocol 서버 for FileBrowser Quantum — REST API를 갖춘 자체 호스팅 파일 관리 웹 인터페이스입니다.

기능

  • 파일 작업: 파일 및 폴더 나열, 읽기, 업로드, 다운로드, 삭제

  • 사용자 관리: 세부 권한이 있는 사용자 생성, 업데이트, 삭제 (관리자 전용)

  • 인증: 세션 지속성을 갖춘 자동 토큰 관리

  • 다중 사용자: 환경 변수를 통한 구성 가능한 자격 증명

  • 오류 처리: 속도 제한 인식을 갖춘 명확한 오류 메시지

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 에이전트 사용 시

~/.hermes/config.yaml에 추가:

mcp_servers:
  filebrowser:
    command: "python3"
    ```yaml
    env:
      FB_URL: "https://your-filebrowser-host"
      FB_USER: "your-username"
      FB_PASSWORD: "your-password"
    ```

다중 사용자 설정

다른 사용자(예: 관리자 vs 제한된 사용자)의 경우 별도의 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