mcpField
Q
qBittorrent MCP 服务

qBittorrent MCP 服务

github.com/pickpppcc其他2917 周前更新
代码仓库

关于 qBittorrent MCP 服务

qBittorrent MCP 服务基于 FastMCP 构建，提供对 qBittorrent WebUI API 的功能性接口。适合需要通过 AI 管理种子下载、限速和文件优先级的用户。

主要功能

  1. 01种子的添加、删除、暂停和恢复
  2. 02Tracker 与标签管理
  3. 03全局和单个种子的上传下载限速
  4. 04文件下载优先级设置
  5. 05查询 qBittorrent 版本信息

适用场景

  1. 01通过 MCP 客户端查看并管理种子列表
  2. 02为指定种子调整上传或下载速度限制
  3. 03设置特定文件的下载优先级

MCP 相关

作为 MCP 服务，将 qBittorrent WebUI API 的操作以工具形式提供给 MCP 客户端调用。

详细介绍

qBittorrent MCP 服务

qBittorrent MCP 是一项基于 FastMCP 的服务，提供用于与 qBittorrent WebUI API 交互的功能接口。

功能列表

此服务提供以下功能：

种子管理
  • add_torrent：向 qBittorrent 添加种子文件
  • delete_torrent：删除指定的种子（可选删除文件）
  • pause_torrent：暂停种子下载
  • resume_torrent：继续种子下载
  • get_torrent_list：获取所有种子的列表
  • search_torrents：搜索种子
Tracker 和标签
  • get_torrent_trackers：获取种子的 tracker 列表
  • add_trackers_to_torrent：向种子添加新的 tracker
  • 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"
            ]
        }
    ]

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。