Skip to main content
Glama
Sign In
enesjakozh

Overseerr MCP Server

by jmagar
Verified
GitHub
TypeScript
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for interacting with Overseerr, a request management and media discovery tool for Plex, allowing users to search for movies and TV shows, get detailed information about media, request media to be added to their library, and view and manage existing requests.

Supervisor MCP

Una integración del Protocolo de Contexto de Modelo (MCP) para Overseerr que permite la interacción en lenguaje natural con su sistema de solicitud de contenido multimedia mediante Claude AI. Este servidor le permite buscar películas y series, realizar solicitudes de contenido multimedia y administrar su instancia de Overseerr con lenguaje conversacional.

Conversaciones de ejemplo

A continuación se muestran algunos ejemplos de conversaciones que puedes tener con Claude usando este servidor:

You: Can you find any recent sci-fi movies? Claude: Let me search for recent science fiction films... [Uses overseerr:search to find recent sci-fi movies] You: That looks good! Can you request the second one? Claude: I'll request that movie for you... [Uses overseerr:request to submit the media request] You: What TV shows are available about cooking? Claude: I'll search for cooking-related TV shows... [Uses overseerr:search with type='tv' to find cooking shows]

Características

Búsqueda de medios

  • Busque entre películas, programas de televisión y personas.
  • Obtenga información detallada sobre los medios, incluidos:
    • Título y fecha de lanzamiento
    • Resumen de la trama
    • Estado de disponibilidad
    • Estado de la solicitud
  • Filtrar por tipo de medio (película/TV/persona)
  • Consultas en lenguaje natural (por ejemplo, "buscar películas de ciencia ficción recientes" o "buscar programas como Breaking Bad")

Solicitudes de medios

  • Solicitar películas y programas de televisión
  • Especificar temporadas individuales para programas de televisión
  • Estado de la solicitud de seguimiento
  • Recibir notificaciones sobre actualizaciones de solicitudes
  • Solicitudes en lenguaje natural (por ejemplo, "solicitar la última película de Batman" o "agregar Succession a mi lista de seguimiento")

Integración

  • Integración perfecta de Claude AI a través del transporte stdio
  • Interacción en tiempo real con su instancia de Overseerr
  • Manejo seguro de claves API
  • Limitación de velocidad y manejo de errores
  • Fácil configuración a través de variables de entorno

Configuración

Prerrequisitos

  • Node.js
  • pnpm
  • Escritorio de Claude
  • Instancia de supervisor

Inicio rápido

  1. Instalar dependencias:
pnpm install
  1. Construir el proyecto:
pnpm build
  1. Configurar el entorno:
# Copy template cp .env.template .env # Edit .env with your values OVERSEERR_URL=your_overseerr_url OVERSEERR_API_KEY=your_api_key
  1. Configurar Claude Desktop:

Linux/Mac:

{ "overseerr": { "command": "node", "args": ["/path/to/overseerr/packages/server/dist/index.js"], "cwd": "/path/to/overseerr", "transport": { "type": "stdio" }, "env": { "OVERSEERR_URL": "your_overseerr_url", "OVERSEERR_API_KEY": "your_api_key" } } }

Windows (tenga en cuenta las barras invertidas dobles):

{ "overseerr": { "command": "node", "args": ["C:\\path\\to\\overseerr\\packages\\server\\dist\\index.js"], "cwd": "C:\\path\\to\\overseerr", "transport": { "type": "stdio" }, "env": { "OVERSEERR_URL": "your_overseerr_url", "OVERSEERR_API_KEY": "your_api_key" } } }
  1. Iniciar el servidor:
pnpm start

Detalles técnicos

Estructura del proyecto

packages/ ├── config/ # Configuration management ├── overseerr/ # Overseerr API client ├── server/ # MCP server implementation └── shared/ # Shared types and utilities

Herramientas disponibles

Buscar medios ( overseerr:search )

Busque películas, programas de televisión y personas en la base de datos de Overseerr.

{ // The search query - can be a title, person, or general description query: string, // Optional: Filter by type // - 'movie': Only search movies // - 'tv': Only search TV shows // - 'person': Only search people type?: 'movie' | 'tv' | 'person' }

Consultas de ejemplo:

  • "En busca del origen"
  • Encuentra programas de TV de 2023
  • "Busca películas con Tom Hanks"

Solicitar medios ( overseerr:request )

Solicita que se agreguen películas o programas de TV a tu biblioteca multimedia.

{ // The TMDB ID of the media to request mediaId: number, // Type of media being requested // - 'movie': Request a movie // - 'tv': Request a TV show mediaType: 'movie' | 'tv', // Optional: For TV shows, specify which seasons to request // If not provided, requests all available seasons seasons?: number[] }

Solicitudes de ejemplo:

  • Solicitar una película: "Solicitar Matrix"
  • Solicitar temporadas específicas: "Agregar temporadas 1 a 3 de The Office"
  • Solicitar todas las temporadas: "Solicitar la serie completa de Breaking Bad"

Configuración

Variables de entorno

  • OVERSEERR_URL : URL de su instancia de Overseerr
  • OVERSEERR_API_KEY : Su clave API de Overseerr

Manejo de errores

El servidor implementa un manejo robusto de errores:

  • Errores de API con mensajes significativos
  • Protección de limitación de velocidad
  • Validación de solicitud
  • Recuperación de errores de conexión

Contribuyendo

  1. Bifurcar el repositorio
  2. Crear una rama de características
  3. Confirme sus cambios
  4. Empujar hacia la rama
  5. Crear una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Tools

Permite a Claude interactuar con Overseerr, lo que permite a los usuarios buscar, solicitar y administrar medios para su biblioteca Plex a través del lenguaje natural.

  1. Example Conversations
    1. Features
      1. Media Search
      2. Media Requests
      3. Integration
    2. Setup
      1. Prerequisites
      2. Quick Start
    3. Technical Details
      1. Project Structure
      2. Available Tools
      3. Configuration
      4. Error Handling
    4. Contributing
      1. License

        Related Resources

        Appeared in Searches

        ID: vs6qmcl6bm