English Français العربية

io.github.rclone-ui/rclone

السجل الرسمي أخرى

MCP server for the Rclone RC API, with selectable toolsets.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package rclone-mcp
Claude Code 
claude mcp add rclone -e 'RCLONE_URL=<RCLONE_URL>' -e 'RCLONE_USER=<RCLONE_USER>' -e 'RCLONE_PASS=<your rclone_pass>' -e 'RCLONE_TOOLSETS=<RCLONE_TOOLSETS>' -e 'RCLONE_READ_ONLY=<RCLONE_READ_ONLY>' -e 'RCLONE_MCP_MAX_OUTPUT=<RCLONE_MCP_MAX_OUTPUT>' -- npx -y rclone-mcp@2.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "rclone": {
            "command": "npx",
            "args": [
                "-y",
                "rclone-mcp@2.0.0"
            ],
            "env": {
                "RCLONE_URL": "<RCLONE_URL>",
                "RCLONE_USER": "<RCLONE_USER>",
                "RCLONE_PASS": "<your rclone_pass>",
                "RCLONE_TOOLSETS": "<RCLONE_TOOLSETS>",
                "RCLONE_READ_ONLY": "<RCLONE_READ_ONLY>",
                "RCLONE_MCP_MAX_OUTPUT": "<RCLONE_MCP_MAX_OUTPUT>"
            }
        }
    }
}

متغيرات البيئة

  • RCLONE_URL A running rclone to use. Without it, rclone-mcp starts its own
  • RCLONE_USER HTTP Basic Auth username for RCLONE_URL
  • RCLONE_PASS سري HTTP Basic Auth password for RCLONE_URL
  • RCLONE_TOOLSETS Comma-separated list of toolsets to enable (default, all, or specific: core, config, operations, sync, jobs, vfs, mount, dangerous, etc.)
  • RCLONE_READ_ONLY Set to 1 to expose only tools that change nothing and return no credentials
  • RCLONE_MCP_MAX_OUTPUT The most characters of output a tool call returns. Defaults to 100000

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. rclone-mcp
  2. Prerequisites
  3. Installation
  4. Configuration
  5. Toolsets
  6. Read-Only Mode
  7. License

rclone-mcp

MCP (Model Context Protocol) server for the Rclone RC API. Gives AI assistants the ability to manage cloud storage remotes, copy/sync files, list directories, and more — all through natural language.

Tools are auto-generated from the rclone-openapi spec using the rclone-sdk client. 98 endpoints, organized into selectable toolsets.

Prerequisites

A running rclone remote control daemon:

rclone rcd --rc-no-auth
# or with auth:
rclone rcd --rc-user=admin --rc-pass=secret

Installation

Cursor / Claude Desktop (stdio)

Add to your .cursor/mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "rclone": {
      "command": "npx",
      "args": ["-y", "rclone-mcp"],
      "env": {
        "RCLONE_URL": "http://localhost:5572"
      }
    }
  }
}
With authentication
{
  "mcpServers": {
    "rclone": {
      "command": "npx",
      "args": ["-y", "rclone-mcp"],
      "env": {
        "RCLONE_URL": "http://localhost:5572",
        "RCLONE_USER": "admin",
        "RCLONE_PASS": "secret"
      }
    }
  }
}
Docker
docker build -t rclone-mcp .

docker run -i --rm \
  -e RCLONE_URL=http://host.docker.internal:5572 \
  rclone-mcp
Streamable HTTP transport

For remote hosting or web-based MCP clients:

npx rclone-mcp http --port 3000

Configuration

Environment Variables
VariableDescriptionDefault
RCLONE_URLrclone RC daemon URLhttp://localhost:5572
RCLONE_USERHTTP Basic Auth username—
RCLONE_PASSHTTP Basic Auth password—
RCLONE_TOOLSETSComma-separated toolset listdefault
RCLONE_READ_ONLYSet to 1 to disable write tools—
CLI Arguments
rclone-mcp [command]

Commands:
  rclone-mcp stdio  Run with stdio transport (default)
  rclone-mcp http   Run with Streamable HTTP transport

Options:
  --toolsets   Comma-separated list of toolsets
  --read-only  Only expose read-only tools
  --port       HTTP port (http command only, default: 3000)

Toolsets

Tools are grouped by API path prefix. Enable only what you need to keep the tool list focused.

ToolsetPathsDefault
core/core/*, /rc/*Yes
config/config/*Yes
operations/operations/*Yes
sync/sync/*Yes
jobs/job/*No
vfs/vfs/*No
mount/mount/*No
serve/serve/*No
cache/cache/*No
debug/debug/*No
backend/backend/*No
options/options/*No
plugins/pluginsctl/*No
fscache/fscache/*No

Special values:

  • default — the four default toolsets (core, config, operations, sync)
  • all — every toolset
Examples
# Default toolsets (55 tools)
npx rclone-mcp

# Everything (98 tools)
RCLONE_TOOLSETS=all npx rclone-mcp

# Just file operations and config
npx rclone-mcp --toolsets operations,config

# Default + mount
npx rclone-mcp --toolsets default,mount

# Read-only mode (no copy, delete, sync, etc.)
npx rclone-mcp --read-only

Read-Only Mode

When --read-only or RCLONE_READ_ONLY=1 is set, only non-mutating tools are registered. This excludes operations like file copy/move/delete, sync, config creation, mount/unmount, etc. Useful for giving AI assistants safe, read-only access.

License

MIT

Made with ☁️ for the rclone community

الأسئلة الشائعة

ما هو io.github.rclone-ui/rclone؟

MCP server for the Rclone RC API, with selectable toolsets.

كيف أثبّت io.github.rclone-ui/rclone؟

يعمل على جهازك. في Claude Code: claude mcp add rclone -e 'RCLONE_URL=<RCLONE_URL>' -e 'RCLONE_USER=<RCLONE_USER>' -e 'RCLONE_PASS=<your rclone_pass>' -e 'RCLONE_TOOLSETS=<RCLONE_TOOLSETS>' -e 'RCLONE_READ_ONLY=<RCLONE_READ_ONLY>' -e 'RCLONE_MCP_MAX_OUTPUT=<RCLONE_MCP_MAX_OUTPUT>' -- npx -y rclone-mcp@2.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.rclone-ui/rclone إلى مفتاح API؟

نعم. يتطلب RCLONE_PASS، وتضبطها في إعداداته.

هل io.github.rclone-ui/rclone مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.rclone-ui/rclone؟

ينشره rclone-ui. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.