jasontulp_mcparr_server
by JasonTulpMedia Library Management for Radarr and Sonarr
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
- Install dependencies:
shell pnpm install
Global Installation
To install MCParr Server globally on your system:
shell
pnpm run install-global
This will make the mcparr command available globally in your terminal.
Configuration
- Set up environment variables:
shell 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.envfile in your project directory with these variables.
Usage
Running Locally
Build and run the server:
shell
pnpm run build
pnpm start
For development:
shell
pnpm run dev
Running Globally
If installed globally, simply run:
shell
mcparr
API Reference
search_media
Search for movies or TV shows with filters:
ts
{
mediaType: "movie" | "series", // Required
year?: number, // Optional
genre?: string // Optional
}
request_download
Request a download for specific media:
ts
{
mediaType: "movie" | "series", // Required
id: number // Required
}
check_status
Check the status of specific media:
ts
{
mediaType: "movie" | "series", // Required
id: number // Required
}
get_system_status
Get system health and storage information:
ts
{
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
About
MCP Server for Radarr and Sonarr services
Resources
Stars
Watchers
Forks
No releases published
No packages published
Languages
- JavaScript 100.0%
Invite Gmail Contacts
