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_mcpMCP工具
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