Skip to main content
Glama
prowlarr-mcp

prowlarr-mcp

by amphineko

prowlarr-mcp

一个用于 Prowlarr 的 MCP 服务器。

设置

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

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

配置:

变量

默认值

描述

PROWLARR_URL

http://localhost:9696

Prowlarr 基础 URL,包括任何 URL 基础路径

PROWLARR_API_KEY

必填

Prowlarr API 密钥

PROWLARR_TIMEOUT_SECONDS

60

HTTP 超时时间,大于 0 且最多 300 秒

PROWLARR_MAX_RESULTS

100

limit 接受的硬性上限

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 tests

Available Tools

1 tool
search_releasesA
Read-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

    A4.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables 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.
      7
      3
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server exposing Prowlarr's API v1 as tools for managing indexers, applications, download clients, and more, including cross-indexer searches and system commands.
      10
      MIT