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
LLM-Konfiguration: Fügen Sie die MCP-Server-URL zur Konfiguration Ihres LLM hinzu.
Discovery: Das LLM fragt die Server-URL ab, um die verfügbaren Tools zu verstehen.
Abfrage: Das LLM sendet JSON-RPC-Anfragen, um IMDB-Daten abzurufen.
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) |
| GET | Serviceinformationen (JSON) |
| POST | JSON-RPC-2.0-Endpunkt |
| POST | MCP-Protokoll-Endpunkt für LLM-Toolaufrufe |
| GET | Health-Check für Cloud-Bereitstellungen |
Verfügbare Tools
Tool | Beschreibung | Parameter |
| Filme nach Titel suchen |
|
| Vollständige Filminformationen abrufen |
|
| Schauspieler/Regisseure suchen |
|
| Personeninfo/Filmografie abrufen |
|
| IMDB Top 250 abrufen |
|
| Besetzung eines Films abrufen |
|
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.pyDer Server läuft unter http://localhost:8080.
Mit Docker ausführen
docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcpCloud-Bereitstellung
Cloud Foundry
cf pushVerwendet die manifest.yaml-Konfiguration.
SAP BTP (Cloud Foundry)
# Build MTA archive
mbt build
# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtarVerwendet die mta.yaml-Konfiguration.
Heroku
heroku create imdb-mcp-server
git push heroku mainVerwendet 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:latestGoogle Cloud Run
gcloud run deploy imdb-mcp \
--source . \
--platform managed \
--allow-unauthenticatedAWS 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 patternsUmgebungsvariablen
Variable | Standard | Beschreibung |
| 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.
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.-