Seafile

Provides MCP access to Seafile, enabling Claude to browse, read, and manage files via natural language.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "setugk-seafile-mcp": {
      "command": "/FULL/PATH/TO/seafile-mcp/venv/bin/python",
      "args": [
        "/FULL/PATH/TO/seafile-mcp/src/server.py"
      ],
      "env": {
        "SEAFILE_URL": "https://your-seafile-server.com",
        "SEAFILE_TOKEN": "your-api-token-here"
      }
    }
  }
}

You set up Seafile MCP Server to let Claude browse, search, read, and manage files on your self-hosted Seafile server using natural language. It connects directly to your Seafile installation, preserving privacy and giving you full control over how you access and modify your files from Claude.

How to use

Once your MCP server is connected, you can ask Claude to look up documents, organize folders, search across libraries, read file contents, generate download or upload links, and perform common file operations. Practical uses include asking for specific files or folders, creating new folders, moving items to archival locations, and quickly locating PDFs, receipts, or contracts. Use natural language prompts like “List all PDFs related to insurance” or “Create a new folder called 2025 Taxes” to interact with your Seafile storage through Claude.

How to install

Prerequisites you need before installation include Python 3.10 or higher and a Seafile server (self-hosted or Seafile Cloud). You also need Claude Desktop or Claude Code to connect to the MCP server.

Step 1 Create a working directory for the MCP server code and the virtual environment.

Step 2 Set up a Python virtual environment to isolate dependencies.

Step 3 Install required dependencies from the project requirements.

Step 4 Generate and configure your Seafile API token to enable secure access.

Step 5 Create a local environment file to store your Seafile URL and token, keeping credentials private.

Step 6 Start the MCP server to verify it runs correctly.

Configuration and runtime details

The MCP server runs as a local process and is started via a Python command in a virtual environment. You will connect Claude to this server using a client configuration that points to the local Python process running the server.

Example project configuration to connect Claude to your MCP server (stdio) is shown here. This runs the server from your local environment and exposes the standard MCP interface for Claude to interact with Seafile.

Security and best practices

Keep your API token secret and never commit the .env file. The token grants access to your Seafile account, so handle it like a password. Use restricted permissions where possible and review code before running to understand exactly what the MCP server does with your data.

Store environment variables securely and limit access to the machine running the MCP server. If possible, rotate tokens periodically and monitor usage for any unusual activity.

Troubleshooting

If the server doesn’t show up in Claude, verify absolute paths are used in the client configuration and that you fully restart the Claude client after changes.

If authentication fails, regenerate the Seafile API token and ensure you copied it exactly with no extra spaces.

For connection issues, confirm the Seafile server URL is correct and reachable from the MCP host. Check for VPN requirements or network access rules.

Notes on tools and capabilities

This MCP server exposes a set of tools to Claude, enabling operations such as listing libraries, reading file contents, listing directories, creating and deleting libraries and folders, renaming or moving items, and generating download or upload links. You can also search for files and retrieve file contents directly.

Available tools

hello

Test that the MCP server is working.

ping_server

Test the connection to your Seafile server.

get_account_info

Retrieve information about your Seafile account.

list_libraries

List all libraries on your Seafile server.

get_library

Get details of a specific library by name or ID.

list_directory

List contents of a folder within a library.

create_library

Create a new library on the Seafile server.

delete_library

Delete a library (permanent!).

create_directory

Create a new folder within a library.

delete_item

Delete a file or folder.

rename_item

Rename a file or folder.

move_item

Move a file or folder to another location.

copy_item

Copy a file or folder to another location.

get_file_content

Read the contents of a text file.

get_file_download_link

Generate a download URL for a file.

get_upload_link

Generate an upload URL for a folder.

search_files

Search for files across libraries (requires search enabled on server).