Rclone MCP

🚀 rclone-mcp

Rclone RC API用のMCP (Model Context Protocol) サーバーです。AIアシスタントに自然言語でクラウドストレージのリモート管理、ファイルのコピー/同期、ディレクトリの一覧表示などの機能を提供します。

ツールは、rclone-sdk クライアントを使用して rclone-openapi 仕様から自動生成されます。98のエンドポイントが選択可能なツールセットに整理されています。

🚀 クイックスタート

このサーバーを使用する前に、実行中の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  stdioトランスポートで実行 (デフォルト)
  rclone-mcp http   ストリーム可能なHTTPトランスポートで実行

オプション:
  --toolsets   カンマ区切りのツールセットリスト
  --read-only  読み取り専用ツールのみを公開
  --port       HTTPポート (httpコマンドのみ、デフォルト: 3000)

ツールセット

ツールはAPIパスの接頭辞でグループ化されています。必要なものだけを有効にして、ツールリストを絞り込みましょう。

特殊な値:

• default — 4つのデフォルトツールセット (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