Skip to main content
Glama
Sign In
enesjakozh

Overseerr MCP Server

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

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

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.

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. Conversaciones de ejemplo
    1. Características
      1. Búsqueda de medios
      2. Solicitudes de medios
      3. Integración
    2. Configuración
      1. Prerrequisitos
      2. Inicio rápido
    3. Detalles técnicos
      1. Estructura del proyecto
      2. Herramientas disponibles
      3. Configuración
      4. Manejo de errores
    4. Contribuyendo
      1. Licencia

        Related Resources

        Related MCP Servers

        • Needle MCP Serverofficial

          needle-ai
          A
          security
          A
          license
          A
          quality
          A server that allows users to manage documents and perform Claude-powered searches using Needle through the Claude Desktop application.
          Last updated -
          7
          39
          Python
          MIT License
          • Apple

        • MCP Server for FTP Access

          alxspiker
          A
          security
          F
          license
          A
          quality
          Enables Claude to interact with FTP servers through natural language commands, allowing users to list directories, download/upload files, create directories, and delete files/directories on FTP servers.
          Last updated -
          6
          5
          JavaScript
          • Linux
          • Apple

        • Inkeep MCP Serverofficial

          inkeep
          -
          security
          A
          license
          -
          quality
          A server that connects Claude to your documentation via Inkeep's API, enabling AI-powered interactions with your documentation content.
          Last updated -
          5
          Python
          MIT License
          • Apple
          • Linux

        • Readwise MCP Server

          IAmAlexander
          -
          security
          A
          license
          -
          quality
          Enables access and interaction with your Readwise library, allowing you to retrieve and search highlights, books, and documents through natural language queries when using Claude or other MCP-compatible assistants.
          Last updated -
          2
          TypeScript
          MIT License

        View all related MCP servers

        Appeared in Searches

        New MCP Servers

        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/jmagar/overseerr-mcp-server'

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