Seafile MCP Server

MCP (Model Context Protocol) server for Seafile cloud storage. Access your self-hosted files from AI assistants like Claude, OpenCode, and other MCP clients.

Features

• List, read, and write files in your Seafile libraries
• Create and manage directories
• Move, copy, and rename files
• Search across libraries
• Supports both account-based and library-specific authentication

Installation

Using pip

pip install seafile-mcp

From source

git clone https://github.com/5p00kyy/seafile-mcp.git
cd seafile-mcp
pip install -e .

Configuration

Create a .env file or set environment variables:

Required

• SEAFILE_SERVER_URL: Your Seafile server URL

Authentication (choose one)

Option 1: Account Authentication (access all libraries)

• SEAFILE_USERNAME: Your email
• SEAFILE_PASSWORD: Your password

Option 2: Library Token (single library, more secure)

• SEAFILE_REPO_TOKEN: API token from library settings
• SEAFILE_REPO_ID: Library UUID

Optional

• SEAFILE_MAX_READ_SIZE: Max file size to read (default: 1MB)
• SEAFILE_MAX_WRITE_SIZE: Max upload size (default: 10MB)
• SEAFILE_TIMEOUT: Request timeout in seconds (default: 30)

Usage with OpenCode

Add to your OpenCode MCP configuration:

{
  "mcpServers": {
    "seafile": {
      "command": "python",
      "args": ["-m", "seafile_mcp"],
      "env": {
        "SEAFILE_SERVER_URL": "https://your-seafile.com",
        "SEAFILE_USERNAME": "user@example.com",
        "SEAFILE_PASSWORD": "your-password"
      }
    }
  }
}

Or with library token:

{
  "mcpServers": {
    "seafile": {
      "command": "seafile-mcp",
      "env": {
        "SEAFILE_SERVER_URL": "https://your-seafile.com",
        "SEAFILE_REPO_TOKEN": "your-api-token",
        "SEAFILE_REPO_ID": "library-uuid"
      }
    }
  }
}

Available Tools

Tool	Description
seafile_list_libraries	List all accessible libraries
seafile_get_library_info	Get library details
seafile_list_directory	List directory contents
seafile_read_file	Read file content
seafile_write_file	Write text to a file
seafile_upload_file	Upload binary file (base64)
seafile_create_directory	Create a folder
seafile_delete	Delete file or folder
seafile_move	Move file or folder
seafile_copy	Copy file or folder
seafile_rename	Rename file or folder
seafile_get_file_info	Get file metadata
seafile_get_download_link	Get download URL
seafile_search	Search files by name

File Handling

• Text files: Content returned directly (up to MAX_READ_SIZE)
• Binary files: Returns metadata and download URL
• Large files: Returns download URL instead of content

Security Notes

• Use library tokens for production (limits access to single library)
• Never commit .env files with credentials
• API tokens can be revoked from Seafile web interface

License

MIT