IMDB MCP Server
IMDB MCP Server
Un servicio JSON-RPC ejecutable en la nube que proporciona acceso a los datos de IMDB. Diseñado para funcionar con LLMs a través del protocolo MCP (Model Context Protocol).
Cómo funciona
Configuración del LLM: Añade la URL del servidor MCP a la configuración de tu LLM
Descubrimiento: El LLM consulta la URL del servidor para comprender las herramientas disponibles
Consulta: El LLM envía solicitudes JSON-RPC para obtener datos de IMDB
Respuesta: El servidor devuelve datos estructurados que el LLM interpreta y explica a los usuarios
Related MCP server: moviefinder-mcp
Endpoints
Endpoint | Método | Descripción |
| GET | Documentación HTML (legible para humanos) |
| GET | Información del servicio (JSON) |
| POST | Endpoint JSON-RPC 2.0 |
| POST | Endpoint del protocolo MCP para invocación de herramientas del LLM |
| GET | Comprobación de estado para despliegues en la nube |
Herramientas disponibles
Herramienta | Descripción | Parámetros |
| Buscar películas por título |
|
| Obtener información completa de la película |
|
| Buscar actores/directores |
|
| Obtener información y filmografía de la persona |
|
| Obtener el Top 250 de IMDB |
|
| Obtener el reparto de una película |
|
Uso de JSON-RPC
Envía una solicitud POST a /jsonrpc:
{
"jsonrpc": "2.0",
"method": "search_movies",
"params": {"query": "The Matrix", "limit": 5},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": [
{"id": "0133093", "title": "The Matrix", "year": 1999},
{"id": "0234215", "title": "The Matrix Reloaded", "year": 2003}
],
"id": 1
}Configuración de MCP del LLM
Añade lo siguiente a la configuración del servidor MCP de tu LLM:
{
"mcpServers": {
"imdb": {
"url": "https://your-deployed-url.com/mcp",
"transport": "http"
}
}
}Desarrollo local
Ejecutar en local
pip install -r requirements.txt
python app.pyEl servidor se ejecuta en http://localhost:8080
Ejecutar con Docker
docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcpDespliegue en la nube
Cloud Foundry
cf pushUtiliza la configuración de manifest.yaml.
SAP BTP (Cloud Foundry)
# Build MTA archive
mbt build
# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtarUtiliza la configuración de mta.yaml.
Heroku
heroku create imdb-mcp-server
git push heroku mainUtiliza Procfile y runtime.txt.
Docker (cualquier nube)
# Build
docker build -t imdb-mcp .
# Run
docker run -p 8080:8080 imdb-mcp
# Push to registry
docker tag imdb-mcp your-registry/imdb-mcp:latest
docker push your-registry/imdb-mcp:latestGoogle Cloud Run
gcloud run deploy imdb-mcp \
--source . \
--platform managed \
--allow-unauthenticatedAWS App Runner / ECS
Utiliza el Dockerfile con el servicio de contenedores de AWS que prefieras.
Estructura del proyecto
imdb-mcp/
├── app.py # FastAPI JSON-RPC server
├── imdb_backend.py # Cinemagoer wrapper
├── server.py # FastMCP server (for local MCP)
├── requirements.txt # Python dependencies
├── pyproject.toml # Project metadata
├── Dockerfile # Container image
├── Procfile # Heroku/PaaS process file
├── runtime.txt # Python version
├── manifest.yaml # Cloud Foundry manifest
├── mta.yaml # SAP BTP MTA descriptor
├── .dockerignore # Docker ignore patterns
└── .cfignore # Cloud Foundry ignore patternsVariables de entorno
Variable | Por defecto | Descripción |
| 8080 | Puerto del servidor |
Notas
Cinemagoer consulta IMDB mediante web scraping, por lo que las respuestas pueden ser más lentas que las soluciones basadas en API
Solo para uso no comercial (según las condiciones de servicio de IMDB)
No se requiere clave API
This server cannot be deployed
Maintenance
Related MCP Connectors
OMDb MCP — IMDB-derived movie / TV / episode data (BYO key)
Movie and series ranking as MCP tools: top titles, search, lookup by IMDb id. Free, no key.
Movies MCP — wraps iTunes Search API (movies, free, no auth) and TVmaze API (TV shows, free, no…
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides access to IMDB movie and person data, including searches, cast details, and top-rated lists through the Model Context Protocol. It enables LLMs to fetch structured cinematic metadata and filmographies using the Cinemagoer backend.1-
- FlicenseAqualityDmaintenanceAn MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.8-
- AlicenseAqualityCmaintenanceMCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.5MIT
- FlicenseNot gradedqualityDmaintenanceA robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.-