README Documentation
qBittorrent MCP 服务
qBittorrent MCP 是一个基于 FastMCP 的服务,提供了与 qBittorrent WebUI API 交互的功能接口。
功能列表
该服务提供了以下功能:
种子管理
add_torrent
: 添加种子文件到 qBittorrentdelete_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密码
使用方法
-
确保已安装所需依赖:
pip install httpx mcp
-
运行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"
]
}
]
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source