prowlarr-mcp

一个用于 Prowlarr 的 MCP 服务器。

设置

cd prowlarr-mcp
uv sync
cp .env.example .env

在 .env 中设置 PROWLARR_API_KEY。API 密钥可在 Prowlarr 的“设置 → 常规 → 安全”下获取。

配置：

Related MCP server: qBittorrent MCP Server

运行

uv run prowlarr-mcp

示例 Codex/OpenCode 风格的 stdio 配置：

{
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/prowlarr-mcp",
    "run",
    "prowlarr-mcp"
  ]
}

工具

search_releases 接受：

• query：文本查询；空字符串请求最近的发布。

• search_type：search、tvsearch、movie、music 或 book。

• indexer_ids：可选的 Prowlarr 索引器 ID。

• categories：可选的 Newznab 类别 ID。

• limit：结果数量，默认 20，受配置上限限制。

• offset：非负的结果偏移量。

响应有意比 Prowlarr 的完整 ReleaseResource 更小， 但保留了 indexer_id 和 guid，以备未来提交下载工作流时使用。 Prowlarr 可能对多个索引器单独应用 limit，因此 MCP 服务器 也会在合并的响应上强制执行该限制。truncated 表示 MCP 服务器 丢弃了收到的部分响应；它不是 has_more 分页指示符， 也无法证明 Prowlarr 是否还有更多结果。

路线图

• v0.1: 通过已配置的 Prowlarr 索引器搜索发布。

• 发现可用的索引器和搜索类别。

• 将选定的发布提交到已配置的下载客户端。

• 检查 Prowlarr 健康状态、索引器状态和搜索历史。

使用 MCP 客户端进行测试

仓库包含一个通用的 stdio 客户端，用于启动服务器并调用一个工具：

uv run src/prowlarr_mcp/scripts/mcp_client.py \
  --command "uv run prowlarr-mcp" \
  --method "search_releases" \
  --arguments '{"query": "yani neko"}'

当服务器命令必须从其他目录运行时，使用 --cwd； 并使用 --timeout 覆盖默认的 60 秒工具调用超时。该脚本 将结构化工具输出打印为 JSON，并在输入无效、连接失败或 MCP 工具错误时以非零状态退出。

开发

uv run ruff format --check .
uv run ruff check .
uv run pyrefly check
uv run python -m unittest discover -s tests