What is Mcparr Server

mcparr-server is an MCP server designed to integrate with Radarr and Sonarr services, enabling users to manage their media libraries effectively.

Use cases

Use cases include managing a personal media library, automating downloads for movies and TV shows, and monitoring system health and storage for media servers.

How to use

To use mcparr-server, install the necessary dependencies and configure environment variables for Radarr and Sonarr. You can run it locally or globally using the provided commands.

Key features

Key features include browsing media libraries, searching and filtering by year and genre, requesting downloads, monitoring download status, and system health management.

Where to use

mcparr-server is used in home media management systems, particularly for users who utilize Radarr and Sonarr for organizing and downloading movies and TV shows.

MCP Radarr and Sonarr Server

An MCP server that integrates with Radarr and Sonarr to manage your media library.

Features

Current Features:

• Browse your movie and TV show library
• Search and filter media by year and genre
• Request downloads for movies and TV shows
• Check download and monitoring status
• System health monitoring and management
  • Disk space monitoring
  • System health checks
  • Status reporting

Installation

Local Installation

1. Install dependencies:

pnpm install

Global Installation

To install MCParr Server globally on your system:

pnpm run install-global

This will make the mcparr command available globally in your terminal.

Configuration

1. Set up environment variables:

export RADARR_URL=http://your-radarr-instance:7878
export RADARR_API_KEY=your-radarr-api-key
export SONARR_URL=http://your-sonarr-instance:8989
export SONARR_API_KEY=your-sonarr-api-key

Alternatively, you can create a .env file in your project directory with these variables.

Usage

Running Locally

Build and run the server:

pnpm run build
pnpm start

For development:

pnpm run dev

Running Globally

If installed globally, simply run:

mcparr

API Reference

search_media

Search for movies or TV shows with filters:

{
  mediaType: "movie" | "series",  // Required
  year?: number,                  // Optional
  genre?: string                  // Optional
}

request_download

Request a download for specific media:

{
  mediaType: "movie" | "series",  // Required
  id: number                      // Required
}

check_status

Check the status of specific media:

{
  mediaType: "movie" | "series",  // Required
  id: number                      // Required
}

get_system_status

Get system health and storage information:

{
  system: "radarr" | "sonarr" | "both"  // Required - Which system to check
}

Response includes:

• System status (version, uptime, etc.)
• Disk space information
• Health check results

Resources

Media is exposed as resources with the following URI schemes:

• Movies: radarr://movie/{id}
• TV Shows: sonarr://series/{id}

Each resource includes:

• Title
• Year
• Current status