Servidor MCP de IMDb

Licencia: MIT Python 3.13 Estibador API rápida insignia de herrería

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

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:
RAPID_API_KEY_IMDB=your_api_key_here

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 :

npx -y @smithery/cli install @uzaysozen/imdb-mcp-server --client claude

Opción 1: Usar Docker (recomendado)

Clonar este repositorio

git clone https://github.com/uzaysozen/imdb-mcp-server.git
cd imdb-mcp-server

Instalar dependencias

pip install -r requirements.txt

Construir la imagen de Docker

docker build -t imdb_server .

Ejecute el contenedor Docker (asegúrese de que su clave API se pase como una variable de entorno)

docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

Agregue esto a su claude_desktop_config.json :

{
  "mcpServers": {
    "imdb_server": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "imdb_server",
        "imdb-mcp-server"
      ],
      "env": {
        "RAPID_API_KEY_IMDB": "your_api_key_here"
      }
    }
  }
}

Opción 2: Ejecución directa de Python

Clonar este repositorio

git clone https://github.com/uzaysozen/imdb-mcp-server.git
cd imdb-mcp-server

Instalar dependencias

pip install -r requirements.txt

Establecer la variable de entorno de la clave API

export RAPID_API_KEY_IMDB=your_api_key_here

Agregue esto a su claude_desktop_config.json , ajustando la ruta de Python según sea necesario:

{
  "mcpServers": {
    "imdb_server": {
      "command": "/path/to/your/python",
      "args": [
        "/path/to/imdb_server.py"
      ],
      "env": {
        "RAPID_API_KEY_IMDB": "your_api_key_here"
      }
    }
  }
}

Iniciando el servidor

# Start the server directly
python imdb_server.py

# Or using MCP CLI
mcp run imdb_server.py

# Or if using Docker, the server starts automatically with the container
docker run -d -p 8000:8000 -e RAPID_API_KEY_IMDB=your_api_key_here --name imdb_server imdb_server

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:

# Default are 600 seconds (10 minutes) and 100 cache keys
response_cache = ResponseCache(expiry_seconds=120, max_size=50)

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

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

Un servidor MCP integral que proporciona datos detallados de IMDb, incluidas películas, programas de televisión y próximos lanzamientos.

Related MCP Servers

mcp-registry-server
KBB99
A
security
A
license
A
quality
Easily find MCP servers using our MCP registry. Search with natural language.
Last updated -
1
5
MIT License
mmnt-mcp-server
zbkm
A
security
A
license
A
quality
MCP server for Mamont search engine
Last updated -
2
2
MIT License
Wayback Machine MCP Server
Cyreslab-AI
A
security
A
license
A
quality
Wayback Machine MCP Server
Last updated -
2
12
MIT License
ChEMBL MCP Server
Augmented-Nature
A
security
A
license
A
quality
ChEMBL MCP Server
Last updated -
27
65
MIT License

View all related MCP servers

imdb-mcp-server

Servidor MCP de IMDb

Tabla de contenido

Descripción general

Características

Configuración

Herramientas

Herramientas de búsqueda

Herramientas de identificación de IMDb

Herramientas de configuración

Herramientas de películas

Herramientas para programas de TV

Próximos lanzamientos Herramientas

Herramientas destacadas de India (paginadas)

Ejemplo de mensaje y respuesta

Instalación

Instalación mediante herrería

Opción 1: Usar Docker (recomendado)

Opción 2: Ejecución directa de Python

Iniciando el servidor

Detalles técnicos

Sistema de paginación

Objetivo

Implementación

Beneficios

Sistema de almacenamiento en caché

Características

Beneficios

Configuración

Limitaciones

Solución de problemas

Licencia

Related MCP Servers

mcp-registry-server

mmnt-mcp-server

Wayback Machine MCP Server

ChEMBL MCP Server

Appeared in Searches

New MCP Servers

MCP directory API