prowlarr-mcp
prowlarr-mcp
一个用于 Prowlarr 的 MCP 服务器。
设置
cd prowlarr-mcp
uv sync
cp .env.example .env在 .env 中设置 PROWLARR_API_KEY。API 密钥可在 Prowlarr 的“设置 → 常规 → 安全”下获取。
配置:
变量 | 默认值 | 描述 |
|
| Prowlarr 基础 URL,包括任何 URL 基础路径 |
| 必填 | Prowlarr API 密钥 |
|
| HTTP 超时时间,大于 0 且最多 300 秒 |
|
|
|
Related MCP server: MCP *arr 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 testsAvailable Tools
1 toolsearch_releasesARead-onlyIdempotent
Search enabled Prowlarr indexers for Torrent or Usenet releases.
An empty query requests recent releases. Omit indexer_ids and categories to search all enabled indexers and categories. Results preserve Prowlarr's ordering. The indexer_id and guid identify a release for a future download submission capability, which is not available in version 0.1.
Inputs: limit, query, offset, categories, +2 more. Returns: limit, query, offset, releases, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of confusing it with another. Its purpose is clearly focused on searching releases, making misselection unnecessary.
search_releases follows a clean verb_noun naming convention. With a single tool there is no conflicting pattern, and the name accurately describes the operation.
A single tool is slightly thin for a server named Prowlarr, but it is appropriate for the currently advertised search-only capability. The missing functionality is explicitly reserved for a future version, so the count is reasonable, not excessive.
The search tool offers robust coverage for querying, filtering by categories or indexer_ids, and fetching recent releases. However, there is no way to discover available indexer_ids or continue from a search result to download submission, and the description explicitly notes that capability is unavailable, leaving a meaningful workflow gap.
Maintenance
Related MCP Connectors
Search the tool catalog. Customer API key required. Catalog metadata is not a security guarantee.
Search OpenAlex papers, authors, institutions and citations. Hosted on Apify; needs an Apify token. Send your own Apify API token as an Authorization: Bearer header.
Search website motion, specs and recreation packs. Account required; OAuth or bearer API key.
Search a curated directory of agent tools, MCP servers, APIs, protocols and skills. No auth.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables interaction with qBittorrent through its Web API to search for torrents using search plugins and manage downloads. Supports torrent searching, downloading via URLs/magnet links, and torrent management operations like pause, resume, and delete.73-
- AlicenseBqualityBmaintenanceEnables unified control of \*arr media management applications (Sonarr, Radarr, Lidarr, Readarr, Prowlarr) through natural language queries. Manage TV shows, movies, music, books, search for content, monitor downloads, and check upcoming releases across all services.732,281 npm247MIT
- AlicenseAqualityDmaintenanceEnables web search capabilities via a SearXNG instance, allowing for filtered searches across categories like news, images, and science. It supports multi-language queries, time-range filtering, and safe search options to provide formatted results with metadata.1180 npmMIT
- AlicenseAqualityCmaintenanceMCP server exposing Prowlarr's API v1 as tools for managing indexers, applications, download clients, and more, including cross-indexer searches and system commands.10MIT