prowlarr-mcp

Un servidor MCP para html.

Configuración

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

Define PROWLARR_API_KEY en .env. La clave de API está disponible en Prowlarr en Configuración → General → Seguridad.

Configuración:

Related MCP server: qBittorrent MCP Server

Ejecución

uv run prowlarr-mcp

Ejemplo de configuración stdio estilo Codex/OpenCode:

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

Herramienta

search_releases acepta:

• query: consulta de texto; una cadena vacía busca lanzamientos recientes.

• search_type: search, tvsearch, movie, music o book.

• indexer_ids: IDs de indexadores de Prowlarr opcionales.

• categories: IDs de categorías Newznab opcionales.

• limit: número de resultados, 20 por defecto y con un tope según la configuración.

• offset: desplazamiento de resultados no negativo.

La respuesta es intencionadamente más pequeña que el ReleaseResource completo de Prowlarr, pero conserva indexer_id y guid para un futuro flujo de trabajo de envío de descargas. Prowlarr puede aplicar limit de forma independiente a varios indexadores, por lo que el servidor MCP también lo aplica a la respuesta combinada. truncated significa que el servidor MCP descartó parte de la respuesta que recibió; no es un indicador de paginación has_more y no puede demostrar si Prowlarr tiene resultados adicionales.

Hoja de ruta

• v0.1: Buscar lanzamientos a través de los indexadores de Prowlarr configurados.

• Descubrir los indexadores disponibles y las categorías de búsqueda.

• Enviar un lanzamiento seleccionado a un cliente de descargas configurado.

• Inspeccionar la salud de Prowlarr, el estado de los indexadores y el historial de búsquedas.

Pruebas con el cliente MCP

El repositorio incluye un cliente stdio genérico para lanzar el servidor y llamar a una herramienta:

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

Usa --cwd cuando el comando del servidor deba ejecutarse desde un directorio distinto, y --timeout para anular el tiempo de espera predeterminado de 60 segundos de las llamadas a herramientas. El script imprime la salida estructurada de la herramienta como JSON y devuelve un código de salida distinto de cero ante entradas no válidas, fallos de conexión o errores de herramientas MCP.

Desarrollo

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