rclone

rclone-mcp

Rclone RC API 用の MCP（Model Context Protocol）サーバーです。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 トランスポート

リモートホスティングまたはウェブベースの MCP クライアント向けです。

npx rclone-mcp http --port 3000

設定

環境変数

変数	説明	デフォルト
RCLONE_URL	rclone RC デーモンの URL	http://localhost:5572
RCLONE_USER	HTTP Basic 認証のユーザー名	—
RCLONE_PASS	HTTP Basic 認証のパスワード	—
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 — デフォルトの 4 つのツールセット（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