Information
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
Ensure that the required dependencies are installed:
pip install httpx mcp
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"
]
\}
]