rclone

Name: rclone
Author: rclone-ui

本地服务

github.com/rclone-ui文件与存储1337 周前更新

代码仓库

关于 rclone

rclone-mcp 是用于管理 rclone RC 守护进程的 MCP 服务，供需要操作存储远程端和文件的 AI 助手使用。可选择工具集，并启用只读模式来限制可用操作。

主要功能

01管理存储远程端
02复制、同步和列出文件
03选择 API 工具集
04只读访问模式
05stdio 和 Streamable HTTP 传输

适用场景

01查看存储远程端中的目录
02复制或同步文件
03提供受限的只读存储访问

MCP 相关

它将 rclone RC API 操作作为工具提供给 MCP 客户端。可选择工具集，也可启用只读模式以排除修改类工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "rclone-ui-rclone": {
      "command": "npx",
      "args": [
        "-y",
        "rclone-mcp"
      ],
      "env": {
        "RCLONE_URL": "<RCLONE_URL>",
        "RCLONE_USER": "<RCLONE_USER>",
        "RCLONE_PASS": "<RCLONE_PASS>",
        "RCLONE_TOOLSETS": "<RCLONE_TOOLSETS>",
        "RCLONE_READ_ONLY": "<RCLONE_READ_ONLY>"
      }
    }
  }
}

启动命令npx -y rclone-mcp

需要配置的环境变量

RCLONE_URLRclone RC daemon URL

RCLONE_USERHTTP Basic Auth username

RCLONE_PASS密钥HTTP Basic Auth password

RCLONE_TOOLSETSComma-separated list of toolsets to enable (default, all, or specific: core, config, operations, sync, jobs, vfs, mount, etc.)

RCLONE_READ_ONLYSet to 1 to disable write tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmrclone-mcp1.0.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
_async	boolean	否	异步运行命令。立即返回 job id。
params	object	否	允许其他任意参数。

详细介绍

rclone-mcp

面向 Rclone RC API 的 MCP（模型上下文协议）服务。让 AI 助手能够通过自然语言管理云存储远程端、复制／同步文件、列出目录等。

工具通过 rclone-sdk 客户端，根据 rclone-openapi 规范自动生成。包含 98 个端点，分为可选工具集。

先决条件

正在运行的 rclone 远程控制守护进程：

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

安装

Cursor / Claude Desktop（stdio）

添加到 .cursor/mcp.json 或 claude_desktop_config.json：

{
  "mcpServers": {
    "rclone": {
      "command": "npx",
      "args": ["-y", "rclone-mcp"],
      "env": {
        "RCLONE_URL": "http://localhost:5572"
      }
    }
  }
}

使用身份验证

{
  "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 传输

用于远程托管或基于 Web 的 MCP 客户端：

npx rclone-mcp http --port 3000

配置

环境变量

变量	描述	默认值
`RCLONE_URL`	rclone RC 守护进程 URL	`http://localhost:5572`
`RCLONE_USER`	HTTP Basic Auth 用户名	—
`RCLONE_PASS`	HTTP Basic Auth 密码	—
`RCLONE_TOOLSETS`	以逗号分隔的工具集列表	`default`
`RCLONE_READ_ONLY`	设置为 `1` 以禁用写入工具	—

CLI 参数

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)

工具集

工具按 API 路径前缀分组。只启用所需工具集，让工具列表保持精简。

工具集	路径	默认启用
`core`	`/core/`、`/rc/`	是
`config`	`/config/*`	是
`operations`	`/operations/*`	是
`sync`	`/sync/*`	是
`jobs`	`/job/*`	否
`vfs`	`/vfs/*`	否
`mount`	`/mount/*`	否
`serve`	`/serve/*`	否
`cache`	`/cache/*`	否
`debug`	`/debug/*`	否
`backend`	`/backend/*`	否
`options`	`/options/*`	否
`plugins`	`/pluginsctl/*`	否
`fscache`	`/fscache/*`	否

特殊值：

default — 四个默认工具集（core、config、operations、sync）
all — 所有工具集

示例

# 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 或 RCLONE_READ_ONLY=1 后，仅注册不会修改数据的工具。这会排除文件复制／移动／删除、同步、创建配置、挂载／卸载等操作。适用于为 AI 助手提供安全的只读访问权限。

许可证

MIT

_{为 rclone 社区倾心打造 ☁️}

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。