mcparr-server

# 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: ```bash pnpm install ``` ### Global Installation To install MCParr Server globally on your system: ```bash pnpm run install-global ``` This will make the `mcparr` command available globally in your terminal. ## Configuration 1. Set up environment variables: ```bash 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: ```bash pnpm run build pnpm start ``` For development: ```bash pnpm run dev ``` ### Running Globally If installed globally, simply run: ```bash mcparr ``` ## API Reference ### search_media Search for movies or TV shows with filters: ```typescript { mediaType: "movie" | "series", // Required year?: number, // Optional genre?: string // Optional } ``` ### request_download Request a download for specific media: ```typescript { mediaType: "movie" | "series", // Required id: number // Required } ``` ### check_status Check the status of specific media: ```typescript { mediaType: "movie" | "series", // Required id: number // Required } ``` ### get_system_status Get system health and storage information: ```typescript { 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