qBittorrent MCP 服务器
一个MCP（模型上下文协议）服务器，它连接到qBittorrent的Web API以搜索和下载种子文件。
特点/特性
- 搜索种子文件使用qBittorrent的搜索插件搜索种子文件
- 下载种子文件通过URL或磁力链接添加种子
- 管理种子文件获取信息、暂停、恢复和删除种子文件
- 列出插件查看可用的搜索插件
先决条件
- qBittorrent（可译为“q比特Torrent”或保持原名，因其是一个特定的软件名称） 启用了Web用户界面
- 从……下载 qbittorrent.org 翻译为中文是“qBittorrent官方网站” - 在qBittorrent中启用Web用户界面： Tools > Options > Web UI - 记下你的用户名、密码和端口（默认：8080）
- 搜索插件 （用于搜索功能）
- 在qBittorrent中： View > Search Engine - 点击右下角的“搜索插件…” - 安装所需的搜索插件
安装
- 打开qbittorrent，进入选项 -> Web界面 -> 启用网页界面，创建登录名并进行设置
- 安装qbittorrent搜索插件
- 克隆此存储库：
git clone
cd qbit-mcp- 安装依赖项：
pip install uv- 配置环境变量：
cp .env.example .env编辑 .env 使用您的qBittorrent凭据：
QBITTORRENT_HOST=http://localhost:8080
QBITTORRENT_USERNAME=admin
QBITTORRENT_PASSWORD=your_password用法
运行MCP服务器
在witsy中，点击左侧面板上的电源插头，添加一台新服务器。
类型： stdio
标签： qbit-mcp
命令： uv
参数： run --with fastmcp --with qbittorrent-api --with python-dotenv fastmcp run C:\directy\to\qbit-mcp\main.py
打开一个新的聊天窗口，点击加号（+）并启用qbit-mcp服务器。
请让大型语言模型（LLM）为你下载一个种子文件。
可用工具
搜索种子文件
使用qBittorrent的搜索插件来搜索种子文件。
参数：
query（字符串，必填）：搜索查询plugins（字符串，可选）：插件名称或“all”（默认：“all”）category(字符串，可选)：按类别过滤（默认：“全部”）
示例：
Search for "ubuntu 24.04" torrents下载种子文件
通过URL或磁力链接下载种子文件。
参数：
url(字符串，必填)：种子文件URL或磁力链接save_path（字符串，可选）：保存种子文件的目录category（字符串，可选）：要分配的类别tags(字符串，可选)：逗号分隔的标签paused（布尔值，可选）：开始时暂停（默认：false）
示例：
Download torrent from magnet:?xt=urn:btih:...获取种子信息
在qBittorrent中获取种子文件信息。
参数：
torrent_hash（字符串，可选）：特定的种子哈希值（如果未提供，则返回所有）
示例：
Show all torrents currently downloadinglist_search_plugins 翻译为中文是“搜索插件列表”
列出所有可用的搜索插件。
示例：
What search plugins are available?暂停种子（或暂停torrent）
暂停种子下载。
参数：
torrent_hash(字符串，必需): 种子文件的哈希值
恢复种子文件
恢复已暂停的种子下载。
参数：
torrent_hash(字符串，必填)：种子文件的哈希值
删除种子文件
从qBittorrent中删除一个种子。
参数：
torrent_hash(字符串，必需): 种子文件的哈希值delete_files（布尔值，可选）：同时删除文件（默认：false）
故障排除
连接问题
- 验证qBittorrent Web用户界面已启用并正在运行
- 检查主机、端口、用户名和密码是否正确
- 确保没有防火墙阻止连接
搜索功能无法正常工作
- 在qBittorrent的搜索引擎中安装搜索插件
- 验证插件是否已启用
- 某些插件可能需要更新
认证失败
- 检查你的用户名和密码
.env - 默认凭据通常是
admin/adminadmin - 你可以在qBittorrent的网页界面设置中更改这些
许可证
麻省理工学院（MIT）
做出贡献
欢迎贡献！请随时提交拉取请求。