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

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