qBittorrent MCP 服务

什么是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。