Skip to main content
Glama
Adarsh2001-dot

IMDB MCP Server

IMDB MCP Server

Ein in der Cloud ausführbarer JSON-RPC-Dienst, der Zugriff auf IMDB-Daten bietet. Entwickelt für die Arbeit mit LLMs über das MCP (Model Context Protocol).

So funktioniert es

  1. LLM-Konfiguration: Fügen Sie die MCP-Server-URL zur Konfiguration Ihres LLM hinzu.

  2. Discovery: Das LLM fragt die Server-URL ab, um die verfügbaren Tools zu verstehen.

  3. Abfrage: Das LLM sendet JSON-RPC-Anfragen, um IMDB-Daten abzurufen.

  4. Antwort: Der Server gibt strukturierte Daten zurück, die das LLM interpretiert und den Benutzern erklärt.

Related MCP server: moviefinder-mcp

Endpunkte

Endpunkt

Methode

Beschreibung

/

GET

HTML-Dokumentation (menschenlesbar)

/info

GET

Serviceinformationen (JSON)

/jsonrpc

POST

JSON-RPC-2.0-Endpunkt

/mcp

POST

MCP-Protokoll-Endpunkt für LLM-Toolaufrufe

/health

GET

Health-Check für Cloud-Bereitstellungen

Verfügbare Tools

Tool

Beschreibung

Parameter

search_movies

Filme nach Titel suchen

query, limit

get_movie_details

Vollständige Filminformationen abrufen

movie_id

search_people

Schauspieler/Regisseure suchen

query, limit

get_person_details

Personeninfo/Filmografie abrufen

person_id

get_top_250_movies

IMDB Top 250 abrufen

limit

get_movie_cast

Besetzung eines Films abrufen

movie_id, limit

JSON-RPC-Nutzung

Senden Sie eine POST-Anfrage an /jsonrpc:

{
    "jsonrpc": "2.0",
    "method": "search_movies",
    "params": {"query": "The Matrix", "limit": 5},
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {"id": "0133093", "title": "The Matrix", "year": 1999},
        {"id": "0234215", "title": "The Matrix Reloaded", "year": 2003}
    ],
    "id": 1
}

LLM-MCP-Konfiguration

Fügen Sie Folgendes zur MCP-Server-Konfiguration Ihres LLM hinzu:

{
    "mcpServers": {
        "imdb": {
            "url": "https://your-deployed-url.com/mcp",
            "transport": "http"
        }
    }
}

Lokale Entwicklung

Lokal ausführen

pip install -r requirements.txt
python app.py

Der Server läuft unter http://localhost:8080.

Mit Docker ausführen

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

Cloud-Bereitstellung

Cloud Foundry

cf push

Verwendet die manifest.yaml-Konfiguration.

SAP BTP (Cloud Foundry)

# Build MTA archive
mbt build

# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtar

Verwendet die mta.yaml-Konfiguration.

Heroku

heroku create imdb-mcp-server
git push heroku main

Verwendet Procfile und runtime.txt.

Docker (beliebige Cloud)

# 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

Verwenden Sie das Dockerfile mit Ihrem bevorzugten AWS-Containerdienst.

Projektstruktur

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

Umgebungsvariablen

Variable

Standard

Beschreibung

PORT

8080

Server-Port

Hinweise

  • Cinemagoer fragt IMDB über Web Scraping ab; die Antworten können langsamer sein als bei API-basierten Lösungen.

  • Nur für nicht-kommerzielle Zwecke (gemäß den IMDB-Nutzungsbedingungen).

  • Kein API-Schlüssel erforderlich.

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