qBittorrent MCP Service

qBittorrent MCP is a service based on FastMCP, providing functional interfaces for interacting with the qBittorrent WebUI API.

Feature List

The service provides the following features:

Torrent Management

• add_torrent: Add a torrent file to qBittorrent
• delete_torrent: Delete a specified torrent (optionally delete files as well)
• pause_torrent: Pause a torrent download
• resume_torrent: Resume a torrent download
• get_torrent_list: Get a list of all torrents

Trackers and Tags

• get_torrent_trackers: Get the list of trackers for a torrent
• add_trackers_to_torrent: Add new trackers to a torrent
• add_torrent_tags: Add tags to a torrent

Speed and Priority Control

• set_global_download_limit: Set the global download speed limit
• set_global_upload_limit: Set the global upload speed limit
• set_torrent_download_limit: Set the download speed limit for a specific torrent
• set_torrent_upload_limit: Set the upload speed limit for a specific torrent
• set_file_priority: Set the download priority for specific files

System Information

• get_application_version: Get the qBittorrent application version

Configuration

The service uses the following configuration parameters:

• DEFAULT_HOST: The host address of the qBittorrent WebUI
• DEFAULT_USERNAME: The username for the qBittorrent WebUI
• DEFAULT_PASSWORD: The password for the qBittorrent WebUI

Usage

1. Ensure that the required dependencies are installed:

   pip install httpx mcp

2. Run the MCP service:

   python main.py

Development

The service is divided into two main files:

• main.py: Defines the MCP service interface and configuration parameters
• api.py: Implements the interaction logic with the qBittorrent WebUI json "mcp_servers": [ { "command": "uv", "args": [ "--directory", "/workspace/PC-Canary/apps/qBittorrent/qbittorrent_mcp", "run", "qbittorrent.py" ] } ]

来源

• 来源：github
• 链接：https://github.com/pickpppcc/qbittorrent-mcp