mcparr

mcparr is an MCP server that integrates Radarr and Sonarr to help you manage your media library. It exposes endpoints to browse your movie and TV show collections, search and filter by year or genre, and request downloads for media. It also provides status checks for individual items and a system health overview, including disk space and health checks. You can access the API to search for media, request downloads, and monitor progress and status across both Radarr and Sonarr integrations.

To run mcparr, install dependencies, build, and start the server locally, or install it globally to use the mcparr command from anywhere. Once running, you can use the provided API reference to interact with your media library. Example capabilities include:

• Search media with filters like mediaType, year, and genre
• Request downloads for specific movies or TV shows by ID
• Check the status of a specific item or the overall system health
• Access resource URIs for movies and TV shows exposed through Radarr and Sonarr

The server communicates with Radarr and Sonarr via their respective APIs. Ensure you have valid API keys and accessible URLs configured in your environment variables or a .env file when running mcparr.

Prerequisites:

• Node.js and npm/yarn/pnpm installed on your system
• Access to Radarr and Sonarr instances with API keys

Local installation:

1. Install dependencies pnpm install
2. Build the project (if required by the package) pnpm run build
3. Start the server locally pnpm start

Global installation:

1. Install the server globally so you can run it as a CLI pnpm run install-global
2. Run the server globally from anywhere mcparr

Configuration:

• Set environment variables for Radarr and Sonarr access: 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, create a .env file in your project directory with these variables.

Notes and tips:

• If you plan to run mcparr in production, consider setting up a .env file or using environment variables in your deployment system.
• Ensure Radarr and Sonarr are reachable from the MCParr server and that the API keys are correct.
• When diagnosing issues, check the system health endpoint get_system_status for disk space and health checks.
• The server exposes resources for Movies and TV Shows via the radarr://movie/{id} and sonarr://series/{id} URIs. Use these in integrations that support custom URI schemes.
• If you upgrade or change endpoints, regenerate API keys in Radarr/Sonarr and update mcparr config accordingly.