Content
# qBittorrent MCP Service
qBittorrent MCP is a service based on FastMCP that provides an interface for interacting with the qBittorrent WebUI API.
## Feature List
The service offers the following functionalities:
### Torrent Management
- `add_torrent`: Add a torrent file to qBittorrent
- `delete_torrent`: Delete a specified torrent (optionally delete files as well)
- `pause_torrent`: Pause torrent download
- `resume_torrent`: Resume torrent download
- `get_torrent_list`: Retrieve 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 global download speed limit
- `set_global_upload_limit`: Set global upload speed limit
- `set_torrent_download_limit`: Set download speed limit for a specific torrent
- `set_torrent_upload_limit`: Set upload speed limit for a specific torrent
- `set_file_priority`: Set download priority for a specific file
### System Information
- `get_application_version`: Get the version of the qBittorrent application
## Configuration
The service uses the following configuration parameters:
- `DEFAULT_HOST`: Host address of the qBittorrent WebUI
- `DEFAULT_USERNAME`: Username for the qBittorrent WebUI
- `DEFAULT_PASSWORD`: Password for the qBittorrent WebUI
## Usage
1. Ensure the required dependencies are installed:
```
pip install httpx mcp
```
2. Run the MCP service:
```
python main.py
```
## Development
The service consists of 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"
]
}
]
```
You Might Also Like
OpenWebUI
Open WebUI is an extensible web interface for customizable applications.

NextChat
NextChat is a light and fast AI assistant supporting Claude, DeepSeek, GPT4...

cherry-studio
Cherry Studio is a multilingual project for creative collaboration.
Companion
Companion is a utility for testing and debugging MCP servers on macOS, iOS,...
Companion
Companion is a utility for testing MCP servers on macOS, iOS, and visionOS.
Companion
Your neighborhood friendly MCP utility for macOS, iOS, and visionOS