qBittorrent MCP 服务
- other
About
什么是qBittorrent MCP 服务？
qBittorrent MCP 服务是一个基于 FastMCP 的服务，提供与 qBittorrent WebUI API 交互的功能接口。适用于希望通过 MCP 协议远程管理 qBittorrent 下载任务的用户。
如何使用qBittorrent MCP 服务？
安装所需依赖：pip install httpx mcp，然后运行 python main.py。服务需要配置 qBittorrent WebUI 的主机地址、用户名和密码（DEFAULT_HOST、DEFAULT_USERNAME、DEFAULT_PASSWORD）。也可通过 MCP 客户端（如 uv）以 JSON 配置形式调用。
关键特性 of qBittorrent MCP 服务
- 添加、删除、暂停、恢复种子
- 获取种子列表及跟踪器信息
- 管理种子标签和跟踪器
- 设置全局和单个种子的下载/上传速度限制
- 设置文件中指定片段的下载优先级
- 获取 qBittorrent 应用程序版本
使用场景 of qBittorrent MCP 服务
- 自动化种子下载与删除流程
- 根据网络状况动态调整全局或种子的速度限制
- 批量向种子添加跟踪器以提升下载速度
- 监控种子状态并执行暂停、恢复、标签管理等操作
常见问题 from qBittorrent MCP 服务
如何配置 qBittorrent MCP 服务？
在代码或运行环境中设置 DEFAULT_HOST（WebUI 地址）、DEFAULT_USERNAME 和 DEFAULT_PASSWORD 三个配置参数。
支持哪些管理操作？
支持种子管理（添加、删除、暂停、恢复）、跟踪器与标签管理、全局及单种子的速度控制、文件优先级设置，以及获取应用程序版本。
如何运行该服务？
首先安装 httpx 和 mcp 库，然后执行 python main.py。也可通过 MCP 客户端（如 uv）指定命令参数运行，例如使用 uv --directory <路径> run qbittorrent.py。
Details
- Author
- pickpppcc
- GitHub stars
- 2
- Category
- other
- Repository
- pickpppcc/qbittorrent-mcp
qBittorrent MCP 服务
qBittorrent MCP 是一个基于 FastMCP 的服务，提供了与 qBittorrent WebUI API 交互的功能接口。
功能列表
该服务提供了以下功能：
种子管理
-add_torrent: 添加种子文件到 qBittorrent
- delete_torrent: 删除指定种子（可选同时删除文件）
- pause_torrent: 暂停种子下载
- resume_torrent: 恢复种子下载
- get_torrent_list: 获取所有种子列表
跟踪器与标签
-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
开发
服务分为两个主要文件：
- main.py: 定义MCP服务接口和配置参数
- api.py: 实现与qBittorrent WebUI的交互逻辑
"mcp_servers": [
{
"command": "uv",
"args": [
"--directory",
"/workspace/PC-Canary/apps/qBittorrent/qbittorrent_mcp",
"run",
"qbittorrent.py"
]
}
]
