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

seafile-mcp