Integrations
Offers Docker deployment support with a pre-configured Docker image, allowing containerized execution of the IMDb MCP server with proper environment variable configuration.
Provides comprehensive access to IMDb movie and TV show data, including search capabilities, detailed information about titles, cast and crew details, top-rated content lists, box office data, upcoming releases, and country-specific movie information with special focus on Indian cinema.
Utilizes RapidAPI's IMDb API service to fetch movie and TV show information, requiring users to set up a RapidAPI account and subscribe to the IMDb API to obtain the necessary API key.
Servidor MCP de IMDb
Un servidor Python que implementa el Protocolo de Contexto de Modelo (MCP) para información de películas y programas de TV utilizando el servicio API de IMDb.
Tabla de contenido
- Descripción general
- Características
- Configuración
- Herramientas
- Ejemplo de mensaje y respuesta
- Instalación
- Iniciando el servidor
- Detalles técnicos
- Limitaciones
- Solución de problemas
- Licencia
Descripción general
Este servidor proporciona un conjunto completo de herramientas para acceder a los datos de IMDb a través de la API de IMDb. Sirve de puente entre los agentes y la base de datos de IMDb, ofreciendo información detallada sobre películas, series, actores, directores y más.
Características
- 🎬 Capacidades de búsqueda de películas y programas de TV
- 📋 Información detallada sobre películas y programas de televisión
- 👨👩👧👦 Información del reparto y el equipo
- 🏆 Listas de contenidos populares y mejor valorados
- 💰 Datos de taquilla
- 🌍 Información cinematográfica específica de cada país (con especial atención al cine indio)
- 🔜 Próximos lanzamientos
- 🔄 Sistema de almacenamiento en caché de respuestas eficiente
Configuración
Este servidor requiere una clave API de RapidAPI para el servicio API de IMDb:
- Crea una cuenta en RapidAPI
- Suscríbete a la API de IMDb en RapidAPI
- Establezca la variable de entorno:Copy
Herramientas
Herramientas de búsqueda
| Herramienta | Descripción | Ejemplo |
|---|---|---|
| búsqueda_imdb | Busque películas y programas de TV con varias opciones de filtrado | search_imdb(primary_title="Inception") |
Herramientas de identificación de IMDb
| Herramienta | Descripción | Ejemplo |
|---|---|---|
| obtener_detalles_imdb | Recupere información detallada sobre una película o programa de televisión | get_imdb_details(imdb_id="tt1375666") |
| obtener_directores | Recuperar los directores de una película | get_directors(imdb_id="tt1375666") |
| obtener_emisión | Recuperar el elenco de una película | get_cast(imdb_id="tt1375666") |
| obtener_escritores | Recuperar a los escritores de una película | get_writers(imdb_id="tt1375666") |
Herramientas de configuración
| Herramienta | Descripción | Ejemplo |
|---|---|---|
| obtener_tipos | Obtenga todos los tipos de contenido disponibles | get_types() |
| obtener_géneros | Obtenga todos los géneros disponibles | get_genres() |
| obtener_países | Obtenga todos los países disponibles | get_countries() |
| obtener_idiomas | Obtenga todos los idiomas disponibles | get_languages() |
Herramientas de películas
Paginado (5 resultados por página)
| Herramienta | Descripción | Ejemplo |
|---|---|---|
| obtener las 250 mejores películas | Consigue las 250 mejores películas de IMDb | get_top_250_movies() |
| obtener_la_mejor_taquilla_de_ee.uu. | Obtenga los récords de taquilla de Estados Unidos | get_top_box_office_us() |
| obtener_las_películas_más_populares | Consigue las películas más populares | get_most_popular_movies() |
Herramientas para programas de TV
Paginado (5 resultados por página)
| Herramienta | Descripción | Ejemplo |
|---|---|---|
| obtener los 250 mejores programas de televisión | Obtenga los 250 mejores programas de TV de IMDb | get_top_250_tv_shows() |
| obtener los programas de televisión más populares | Obtenga los programas de televisión más populares | get_most_popular_tv_shows() |
Próximos lanzamientos Herramientas
Paginado (5 resultados por página)
| Herramienta | Descripción | Ejemplo |
|---|---|---|
| obtener_próximos_lanzamientos | Obtenga los próximos lanzamientos de películas y programas de televisión por país | get_upcoming_releases(country_code="US", type="MOVIE") |
| obtener códigos de país disponibles para próximos lanzamientos | Obtenga los códigos de país disponibles para los próximos lanzamientos | get_available_country_codes_for_upcoming_releases() |
Herramientas destacadas de India (paginadas)
Paginado (5 resultados por página)
| Herramienta | Descripción | Ejemplo |
|---|---|---|
| Consigue las películas malayalam mejor valoradas | Consigue las 50 películas malayalam mejor valoradas | get_top_rated_malayalam_movies() |
| obtener_próximas_películas_indias | Consigue las próximas películas indias más esperadas | get_upcoming_indian_movies() |
| películas tamiles de moda | Obtenga películas tamiles de moda | get_trending_tamil_movies() |
| películas en telugu de moda | Obtenga películas telugu de moda | get_trending_telugu_movies() |
| Consigue las películas tamiles mejor valoradas | Obtenga las 50 películas tamil mejor calificadas | get_top_rated_tamil_movies() |
| Consigue las películas en telugu mejor valoradas | Obtenga las 50 películas en telugu mejor valoradas | get_top_rated_telugu_movies() |
| Consigue las películas indias mejor valoradas | Obtenga las 250 películas indias mejor valoradas | get_top_rated_indian_movies() |
Ejemplo de mensaje y respuesta
¿Cuáles son las 5 películas de acción que se estrenarán en el futuro más cercano?
Encontraré las próximas películas de acción para ti.
Herramienta MCP llamada get_upcoming_releases
Ahora buscaré las películas de acción de estos próximos estrenos:
Herramienta MCP llamada get_upcoming_releases
Según los resultados de la búsqueda, aquí están las 5 próximas películas de acción que se estrenarán en el futuro más cercano:
- Una película de Minecraft (4 de abril de 2025)
- Géneros: Acción, Aventura, Comedia
- Descripción: Cuatro inadaptados son arrastrados a través de un portal hacia un país de las maravillas cúbico y se embarcan en una búsqueda con un artesano experto para regresar a casa.
- Cuentos Freaky (4 de abril de 2025)
- Géneros: Acción, Aventura, Comedia
- Descripción: Cuatro historias interconectadas ambientadas en Oakland, California, en 1987 sobre el amor por la música, las películas, las personas, los lugares y los recuerdos.
- Despierta (4 de abril de 2025)
- Géneros: Acción, Terror
- Descripción: Jóvenes activistas invaden una tienda de muebles para protestar por problemas ambientales, pero se encuentran atrapados con un guardia nocturno obsesionado con la caza.
- Guerra (11 de abril de 2025)
- Géneros: Acción, Drama, Guerra
- Descripción: Basado en las experiencias de la vida real del ex-Navy SEAL Ray Mendoza durante la guerra de Irak.
- El Amateur (11 de abril de 2025)
- Géneros: Acción, Suspenso
- Descripción: Un criptógrafo de la CIA chantajea a su agencia para que lo entrene para perseguir a los terroristas que mataron a su esposa.
Instalación
Instalación mediante herrería
Para instalar IMDb Server para Claude Desktop automáticamente a través de Smithery :
Opción 1: Usar Docker (recomendado)
- Clonar este repositorio
- Instalar dependencias
- Construir la imagen de Docker
- Ejecute el contenedor Docker (asegúrese de que su clave API se pase como una variable de entorno)
- Agregue esto a su
claude_desktop_config.json:
Opción 2: Ejecución directa de Python
- Clonar este repositorio
- Instalar dependencias
- Establecer la variable de entorno de la clave API
- Agregue esto a su
claude_desktop_config.json, ajustando la ruta de Python según sea necesario:
Iniciando el servidor
Después de agregar la configuración elegida, reinicia Claude Desktop para cargar el servidor de IMDb. Podrás usar todas las herramientas de datos de películas y series en tus conversaciones con Claude.
Detalles técnicos
El servidor está construido sobre:
- API de IMDb a través de RapidAPI
- MCP para interfaz API
- Solicitudes de comunicación API
- FastMCP para la implementación del servidor
- Sistema de almacenamiento en caché en memoria personalizado
- Paginación inteligente que limita los resultados a 5 elementos por solicitud, optimizando el consumo del agente de IA
Sistema de paginación
Todas las herramientas de recuperación de datos implementan la paginación para mejorar el rendimiento del agente de IA:
Objetivo
- Respuestas optimizadas para IA : limita cada respuesta a 5 elementos, lo que evita la sobrecarga en los agentes de IA que procesan los datos.
- Resultados enfocados : ayuda a los agentes a proporcionar información más relevante y concisa a los usuarios
- Procesamiento mejorado : reduce la carga cognitiva de los agentes de IA al analizar datos de películas y programas de televisión.
Implementación
- Cada punto final paginado acepta un parámetro
start(predeterminado: 0) - Los resultados incluyen metadatos de navegación (totalCount, hasMore, nextStart)
- Tamaño de página consistente de 5 elementos en todos los puntos finales de la colección
- Ejemplo de solicitud con paginación:
get_top_250_movies(start=5)devuelve los elementos 6 a 10
Beneficios
- Mejores respuestas de los agentes : evita que los agentes de IA reciban demasiados datos a la vez
- Información manejable : crea fragmentos de datos digeribles que los agentes pueden procesar de manera eficaz
- Acceso secuencial : permite la exploración estructurada de grandes conjuntos de datos a través de múltiples llamadas de herramientas
Sistema de almacenamiento en caché
El servidor implementa un sistema de almacenamiento en caché eficiente para mejorar el rendimiento y reducir las llamadas a la API:
Características
- Caché en memoria : almacena las respuestas de la API en la memoria para una rápida recuperación
- Caducidad y tamaño configurables : las entradas de caché caducan después de un período de tiempo personalizable (predeterminado: 10 minutos) y tienen un tamaño predeterminado de 100 claves de caché.
- Limpieza automática de caché : elimina periódicamente (predeterminado: 5 minutos) las entradas caducadas para administrar el uso de memoria mediante un hilo en segundo plano.
- Claves de caché : generadas en función de la URL y los parámetros de consulta para garantizar la unicidad
Beneficios
- Uso reducido de API : ayuda a mantenerse dentro de los límites de velocidad de la API al reutilizar las respuestas
- Tiempos de respuesta más rápidos : elimina la latencia de la red para consultas almacenadas en caché
- Rentabilidad : minimiza la cantidad de llamadas a la API, especialmente para consultas populares o repetidas
Configuración
El tamaño de la caché y el tiempo de expiración se pueden ajustar en el código:
Limitaciones
- Se aplican límites de velocidad de API según su suscripción a RapidAPI
- Es posible que cierta información detallada requiera llamadas API adicionales
- Los resultados de la búsqueda pueden estar limitados a una cierta cantidad de elementos por solicitud.
- La caché en memoria se pierde cuando se reinicia el servidor
- Todas las respuestas paginadas devuelven un máximo de 5 elementos por página.
Solución de problemas
| Problema | Solución |
|---|---|
| Clave API no reconocida | Asegúrese de que la variable de entorno RAPID_API_KEY_IMDB esté configurada correctamente |
| Límite de velocidad excedido | Consulte su nivel y límites de suscripción de RapidAPI |
| Errores de tiempo de espera | El servidor tiene un tiempo de espera de 30 segundos; para solicitudes grandes, intente limitar los parámetros |
| Resultados vacíos | Pruebe con términos de búsqueda más amplios o verifique si el contenido existe en la base de datos de IMDb |
| Alto uso de memoria | Si se ejecuta durante períodos prolongados con muchas consultas únicas, reinicie el servidor ocasionalmente para borrar el caché |
Licencia
Este servidor MCP está disponible bajo la licencia MIT.
This server cannot be installed
Un servidor MCP integral que proporciona datos detallados de IMDb, incluidas películas, programas de televisión y próximos lanzamientos.