Rclone MCP

🚀 rclone-mcp

rclone-mcp 是一個為 Rclone RC API 提供支持的 MCP（Model Context Protocol）服務器。它賦予 AI 助手通過自然語言管理雲存儲遠程設備、複製/同步文件、列出目錄等能力。工具是根據 rclone-openapi 規範，使用 rclone-sdk 客戶端自動生成的，擁有 98 個端點，並組織成可選擇的工具集。

🚀 快速開始

在使用 rclone-mcp 之前，需要運行一個 rclone 遠程控制守護進程：

rclone rcd --rc-no-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

可流式傳輸的 HTTP 傳輸

對於遠程託管或基於 Web 的 MCP 客戶端：

npx rclone-mcp http --port 3000

📚 詳細文檔

配置

環境變量

CLI 參數

rclone-mcp [command]

命令:
  rclone-mcp stdio  使用標準輸入輸出傳輸運行（默認）
  rclone-mcp http   使用可流式傳輸的 HTTP 傳輸運行

選項:
  --toolsets   以逗號分隔的工具集列表
  --read-only  僅暴露只讀工具
  --port       HTTP 端口（僅適用於 http 命令，默認值：3000）

工具集

工具按 API 路徑前綴分組。你可以只啟用你需要的工具集，以保持工具列表的針對性。

特殊值：

• default — 四個默認工具集（core、config、operations、sync）
• all — 所有工具集

示例

# 默認工具集（55 個工具）
npx rclone-mcp

# 所有工具（98 個工具）
RCLONE_TOOLSETS=all npx rclone-mcp

# 僅文件操作和配置
npx rclone-mcp --toolsets operations,config

# 默認 + 掛載
npx rclone-mcp --toolsets default,mount

# 只讀模式（無複製、刪除、同步等操作）
npx rclone-mcp --read-only

只讀模式

當設置 --read-only 或 RCLONE_READ_ONLY=1 時，僅註冊非修改性工具。這排除了文件複製/移動/刪除、同步、配置創建、掛載/卸載等操作。這對於為 AI 助手提供安全的只讀訪問非常有用。

📄 許可證

本項目採用 MIT 許可證。