🧲 A qBittorrent MCP server written in Rust 🤖
概览
This project is currently in active development (v0.3.9) and is . Features may change, and breaking changes may occur without notice. A Model Context Protocol (MCP) server for qBittorrent, written in Rust. This tool empowers AI agents to interact with and manage your qBittorrent instance using natural language. - : Search for torrents using qBittorrent's built-in search engine plugins. - : - Manage multiple qBittorrent instances simultaneously. - List all torrents with status, progress, and speed. - Add torrents via Magnet URIs or HTTP URLs. - : Perform actions like pause, resume, reannounce, set category, and add tags via a single manage_torrents tool. - : - : Retrieve properties, files, and trackers in a single call via inspect_torrent. - Deep file listing and tracker status monitoring. - : - : Monitor global speeds, data usage, and limits via a unified get_system_info tool. - Ban peers and update application preferences.
README
以下为原文 README 节选，完整内容请查看原文。
:magnet: qBittorrent MCP Server (Rust) :robot:
[!WARNING] This project is currently in active development (v0.3.9) and is not production-ready. Features may change, and breaking changes may occur without notice.
A Model Context Protocol (MCP) server for qBittorrent, written in Rust. This tool empowers AI agents to interact with and manage your qBittorrent instance using natural language.
:sparkles: Features
- :globe_with_meridians: Search: Search for torrents using qBittorrent’s built-in search engine plugins.
- :card_file_box: Torrent Management:
- Manage multiple qBittorrent instances simultaneously.
- List all torrents with status, progress, and speed.
- Add torrents via Magnet URIs or HTTP URLs.
- Unified Control: Perform actions like pause, resume, reannounce, set category, and add tags via a single
manage_torrentstool.
- :mag: Torrent Inspection:
- Consolidated Inspection: Retrieve properties, files, and trackers in a single call via
inspect_torrent. - Deep file listing and tracker status monitoring.
- Consolidated Inspection: Retrieve properties, files, and trackers in a single call via
- :traffic_light: Global Control:
- System Health: Monitor global speeds, data usage, and limits via a unified
get_system_infotool. - Ban peers and update application preferences.
- System Health: Monitor global speeds, data usage, and limits via a unified
- :label: Categories & Tags: Organize torrents using categories and tags with simplified management tools.
- :mega: Proactive Notifications: Receive real-time notifications when downloads finish (powered by the Sync API).
- :broom: Maintenance Macros:
cleanup_completed: Auto-remove torrents based on seeding ratio or age.mass_rename: Bulk rename files within torrents using Regex.find_duplicates: Identify redundant downloads by name.
- :bulb: Troubleshooting Prompts: Consolidated
troubleshoot_torrentprompt for guided workflows. - :sleeping: Lazy Mode: Reduce token usage by hiding advanced tools until explicitly requested.
- :gear: Configuration: TOML, YAML, JSON, or Environment Variables.
- :rocket: Transports: Stdio (default) and HTTP (SSE with optional token auth).
- :books: Resources: Scoped resources for all instances (e.g.,
qbittorrent://seedbox/torrents).
:hammer_and_wrench: Available Tools
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"qbittorrent": {
"command": "/path/to/qbittorrent-mcp-rs",
"args": [
"--qbittorrent-host", "localhost",
"--qbittorrent-port", "8080",
"--qbittorrent-username", "admin",
"--qbittorrent-password", "adminadmin"
]
}
}
}