种子搜索管理服务器

一个通过Prowlarr进行种子搜索并通过Transmission或qBittorrent管理下载的服务器。

  • by kengbailey
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 kengbailey/torrent-mcp

使用说明

torrent mcp

用于种子搜索和管理的MCP服务器。通过搜索 Prowlarr (REST API),通过 传输 或 qBittorrent.

内置于 FastMCP 3.x使用流式HTTP传输。

设置

python -m venv .venv && source .venv/bin/activate
pip install -e .

配置

所有通过环境变量进行的配置:

变量 默认值 描述
TORRENT_BACKEND transmission transmission 或 qbittorrent
PROWLARR_URL http://localhost:9696 Prowlarr基本URL
PROWLARR_API_KEY (必填) Prowlarr API密钥
TRANSMISSION_URL http://localhost:9091/transmission/rpc 传输RPC URL
TRANSMISSION_USERNAME 传输用户名
TRANSMISSION_PASSWORD 传输密码
QBITTORRENT_URL http://localhost:8080 qBittorrent WebUI URL
QBITTORRENT_USERNAME admin qBittorrent用户名
QBITTORRENT_PASSWORD adminadmin qBittorrent密码
MCP_HOST 127.0.0.1 服务器绑定主机
MCP_PORT 8000 服务器绑定端口

运行(Docker)

cp .env.example .env        # edit .env with your values
docker compose up -d

服务器将在 127.0.0.1:6735.

运行(本地)

PROWLARR_API_KEY=your-key python -m torrent_mcp

MCP工具

  • search_torrents / list_indexers --Prowlarr搜索
  • list_torrents / get_torrent / add_torrent --torrent管理
  • start_torrent / stop_torrent / remove_torrent --洪流控制
  • get_session_stats --传输统计数据和磁盘空间

测试

pip install -e ".[dev]"
pytest