AI导哈

云存储管理协议服务

为Rclone RC API提供的MCP服务器，允许AI助手通过自然语言管理云存储、复制/同步文件、列出目录等。

  • by rclone-ui
  • TypeScript
  • 混合部署
  • 13 星标
  • 更新于
在 GitHub 查看 rclone-ui/rclone-mcp

使用说明

rclone mcp

MCP（模型上下文协议）服务器 Rclone RC API。使AI助手能够管理云存储远程、复制/同步文件、列出目录等，所有这些都可以通过自然语言实现。

工具是从自动生成的 rclone openapi 规范使用 rclone sdk 客户。98个端点，组织成可选择的工具集。

先决条件

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

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

安装

光标/克劳德桌面（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 build -t rclone-mcp .

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

可流式HTTP传输

对于远程托管或基于web的MCP客户端：

npx rclone-mcp http --port 3000

配置

环境变量

变量 描述 默认值
RCLONE_URL rclone RC守护程序URL http://localhost:5572
RCLONE_USER HTTP基本身份验证用户名 --
RCLONE_PASS HTTP基本身份验证密码 --
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 --四个默认工具集（核心、配置、操作、同步）
  • 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助手提供安全、只读的访问权限。

许可证

麻省理工学院

Made with ☁️ for the rclone community

相关 MCP