Skip to main content
Glama
mcpnexus-registry

yarr-media-stack-mcp

by mcpnexus-registry
OverviewSchemaRelated ServersScoreDiscussions
Remote

🎬 YARR Media Stack MCP Server

A comprehensive Model Context Protocol (MCP) server that bridges the gap between Large Language Models (LLMs) and your self-hosted media technology stack. This project enables intelligent automation and natural language control of your media services while maintaining traditional programmatic access.

🎯 Key Features

  • 🤖 LLM-powered natural language control of media services

  • 🔌 Modular architecture for easy service integration

  • 🔄 Unified API gateway for traditional access

  • 🎮 Web UI for visual control (planned)

  • 🔐 Direct API access without LLM middleware

  • 🧩 Extensible plugin system for new services

Related MCP server: OpenAPI MCP Server

📚 Documentation

🏗️ Project Structure

This monorepo is organized into modular packages, each serving a specific purpose:

  • 📦 packages/server: Core MCP server implementation

  • 🌐 packages/web: Web UI interface (planned)

  • 💬 packages/chatbot: LLM chat interface (planned)

  • 🔀 packages/api-gateway: API routing and service coordination (planned)

🔧 Integrated Services

✅ Currently Supported

  • Gotify - Notification Management

  • Sonarr - TV Show Management

  • Prowlarr - Indexer Management

  • Overseerr - Request Management

🚧 Planned Integrations

  • Radarr - Movie Management

  • qBittorrent - Torrent Management

  • SABnzbd - Usenet Downloads

  • Plex - Media Server

  • Tautulli - Server Statistics

  • TMDB - Media Database

📖 Service Documentation

🟢 Currently Integrated

📋 Planned Integration

🧪 Development

Testing Tools

🛠️ SDK References

🏛️ Architecture

The project follows a modular architecture where each service package contains:

  • 🔌 API client implementation

  • 📝 Type definitions

  • 🛠️ MCP tools for service interaction

  • 🛣️ API routes

This architecture supports multiple interaction methods:

  1. LLM-Powered Control: Natural language processing for intuitive media management

  2. Traditional API Access: Direct API calls through the unified gateway

  3. Web Interface: Visual control panel for service management (planned)

  4. Chatbot Interface: Conversational UI for service control (planned)

The modular design allows for:

  • Easy addition of new services

  • Independent service deployment

  • Flexible interaction methods

  • Consistent API patterns across services

🚀 Getting Started

Prerequisites

# Clone and setup repository
git clone https://github.com/jmagar/yarr
cd yarr
pnpm install

Configuration

  1. Create .env file from template:

cp .env.template .env

Then add your service API keys:

# Sonarr Configuration
SONARR_URL=http://localhost:8989
SONARR_API_KEY=your_sonarr_api_key

# Prowlarr Configuration  
PROWLARR_URL=http://localhost:9696
PROWLARR_API_KEY=your_prowlarr_api_key

# Overseerr Configuration
OVERSEERR_URL=http://localhost:5055
OVERSEERR_API_KEY=your_overseerr_api_key

# Gotify Configuration
GOTIFY_URL=http://localhost:8080
GOTIFY_APP_TOKEN=your_gotify_app_token
GOTIFY_CLIENT_TOKEN=your_gotify_client_token  # Optional, for receiving messages

  1. Configure Claude Desktop:

Important: Use full paths in your configuration to ensure Claude Desktop can find the executables and project directory.

{
  "mcpServers": {
    "yarr": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\path\\to\\yarr\\packages\\server\\dist\\index.js"],
      "cwd": "C:\\path\\to\\yarr",
      "transport": {
        "type": "stdio"
      },
      "env": {
        "NODE_ENV": "production",
        "PROWLARR_URL": "http://localhost:9696",
        "PROWLARR_API_KEY": "your_prowlarr_api_key",
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your_sonarr_api_key",
        "OVERSEERR_URL": "http://localhost:5055",
        "OVERSEERR_API_KEY": "your_overseerr_api_key",
        "GOTIFY_URL": "http://localhost:8080",
        "GOTIFY_APP_TOKEN": "your_gotify_app_token",
        "GOTIFY_CLIENT_TOKEN": "your_gotify_client_token"
      }
    }
  }
}

Note: Replace C:\\path\\to\\yarr with your actual project directory path.

Available Tools

Sonarr

// Series Management
sonarr:search              - Search for TV shows
sonarr:list-series         - List all monitored TV series  
sonarr:series-details      - Get detailed information about a series
sonarr:add-series         - Add a new series to monitor
sonarr:monitor-season     - Monitor or unmonitor a season
sonarr:list-profiles      - List quality and language profiles
sonarr:upcoming          - Get upcoming episodes
sonarr:queue             - Get current download queue
sonarr:remove-from-queue - Remove item from download queue

Prowlarr

prowlarr:search           - Search across all indexers
prowlarr:list-indexers    - List configured indexers
prowlarr:indexer-stats    - Get indexer performance stats
prowlarr:check-config     - Validate Prowlarr connection

Overseerr

overseerr:search          - Search for movies and TV shows
overseerr:request         - Request a movie or TV show
overseerr:list-requests   - List media requests
overseerr:update-request  - Update request status
overseerr:trending        - Get trending media with recommendations
overseerr:available       - Get popular available media
overseerr:status          - Get system status

Gotify

gotify:messages:list      - List messages with pagination
gotify:messages:send      - Send a new message
gotify:messages:delete    - Delete a message by ID
gotify:messages:cleanup   - Delete old messages
gotify:apps:list         - List all applications
gotify:apps:create       - Create a new application
gotify:clients:list      - List all clients
gotify:clients:create    - Create a new client
gotify:health           - Check Gotify server health
gotify:stats            - Get Gotify statistics

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mcpnexus-registry/yarr'

If you have feedback or need assistance with the MCP directory API, please join our Discord server