qBittorrent MCP 服务

qBittorrent MCP サービス

qBittorrent MCP は、qBittorrent WebUI API と連携するための機能インターフェースを提供する、FastMCP ベースのサービスです。

機能一覧

このサービスは以下の機能を提供します:

トレント管理

• add_torrent: qBittorrent にトレントファイルを追加します
• delete_torrent: 指定したトレントを削除します（オプションでファイルも削除）
• pause_torrent: トレントのダウンロードを一時停止します
• resume_torrent: トレントのダウンロードを再開します
• get_torrent_list: すべてのトレントのリストを取得します
• search_torrents: トレントを検索します

トラッカーとタグ

• get_torrent_trackers: トレントのトラッカーリストを取得します
• add_trackers_to_torrent: トレントに新しいトラッカーを追加します
• add_torrent_tags: トレントにタグを追加します

速度と優先度の制御

• set_global_download_limit: グローバルのダウンロード速度制限を設定します
• set_global_upload_limit: グローバルのアップロード速度制限を設定します
• set_torrent_download_limit: 特定のトレントのダウンロード速度制限を設定します
• set_torrent_upload_limit: 特定のトレントのアップロード速度制限を設定します
• set_file_priority: 特定のファイルのダウンロード優先度を設定します

システム情報

• get_application_version: qBittorrent アプリケーションのバージョンを取得します

設定

このサービスは以下の設定パラメータを使用します:

• DEFAULT_HOST: qBittorrent WebUI のホストアドレス
• DEFAULT_USERNAME: qBittorrent WebUI のユーザー名
• DEFAULT_PASSWORD: qBittorrent WebUI のパスワード

使用方法

1. 必要な依存関係がインストールされていることを確認します:

   pip install httpx mcp
   

2. MCP サービスを実行します:

   python main.py
   

開発

このサービスは主に 2 つのファイルに分かれています:

• main.py: MCP サービスインターフェースと設定パラメータを定義します
• api.py: qBittorrent WebUI とのやり取りロジックを実装します

   "mcp_servers": [
        {
            "command": "uv",
            "args": [
                "--directory",
                "/workspace/PC-Canary/apps/qBittorrent/qbittorrent_mcp",
                "run",
                "qbittorrent.py"
            ]
        }
    ]