Skip to main content
Glama
Adarsh2001-dot

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

  1. Configuración del LLM: Añade la URL del servidor MCP a la configuración de tu LLM

  2. Descubrimiento: El LLM consulta la URL del servidor para comprender las herramientas disponibles

  3. Consulta: El LLM envía solicitudes JSON-RPC para obtener datos de IMDB

  4. 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)

/info

GET

Información del servicio (JSON)

/jsonrpc

POST

Endpoint JSON-RPC 2.0

/mcp

POST

Endpoint del protocolo MCP para invocación de herramientas del LLM

/health

GET

Comprobación de estado para despliegues en la nube

Herramientas disponibles

Herramienta

Descripción

Parámetros

search_movies

Buscar películas por título

query, limit

get_movie_details

Obtener información completa de la película

movie_id

search_people

Buscar actores/directores

query, limit

get_person_details

Obtener información y filmografía de la persona

person_id

get_top_250_movies

Obtener el Top 250 de IMDB

limit

get_movie_cast

Obtener el reparto de una película

movie_id, limit

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.py

El servidor se ejecuta en http://localhost:8080

Ejecutar con Docker

docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcp

Despliegue en la nube

Cloud Foundry

cf push

Utiliza 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.mtar

Utiliza la configuración de mta.yaml.

Heroku

heroku create imdb-mcp-server
git push heroku main

Utiliza 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:latest

Google Cloud Run

gcloud run deploy imdb-mcp \
    --source . \
    --platform managed \
    --allow-unauthenticated

AWS 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 patterns

Variables de entorno

Variable

Por defecto

Descripción

PORT

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

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides 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
    -
  • F
    license
    A
    quality
    D
    maintenance
    An 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
    -
  • A
    license
    A
    quality
    C
    maintenance
    MCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.
    5
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    A robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.
    -