IMDb MCP-Server 🎬

Ein leistungsstarker Model Context Protocol (MCP)-Server zum Suchen, Entdecken und Abspielen von Inhalten von IMDb. Dieser Server wurde mit FastMCP erstellt und bietet eine robuste Brücke zwischen LLMs und Film-Metadaten, inklusive einer benutzerdefinierten Wiedergabeebene und einem modernen Web-Dashboard.

✨ Funktionen

• 🚀 FastMCP-Engine: Hochleistungsfähige MCP-Implementierung über streamfähiges HTTP.

• 🔍 Intelligente Suche: Angepasste Suchlogik unter Verwendung der IMDb-Autocomplete-API für eine zuverlässige, nicht authentifizierte Titelermittlung.

• 📺 Wiedergabeebene: Direkte Integration mit playimdb.com für sofortige Streaming-Links.

• 📊 Monitoring-Dashboard: Passwortgeschützte WebUI zur Überwachung von Metriken, Tools und Systemstatus in Echtzeit.

• 🐳 Docker-bereit: Optimiertes Multi-Stage-Dockerfile für eine einfache Bereitstellung.

• 🤖 GitHub Actions: Automatisierter CI/CD-Workflow zum Erstellen und Pushen von Images zu GHCR bei Release-Tags.

🛠️ Enthaltene Tools

🚀 Schnellstart

1. Abhängigkeiten installieren

npm install

2. Umgebung konfigurieren

cp .env.example .env

Bearbeiten Sie .env, um Ihr WEBUI_PASSWORD festzulegen.

3. Entwicklungsserver starten

npm run dev

🌐 Endpunkte

• MCP-Endpunkt: http://127.0.0.1:8080/mcp

• Dashboard: http://127.0.0.1:8080/dashboard

• Health-Check: http://127.0.0.1:8080/health

🐳 Docker-Bereitstellung

Erstellen Sie das Image lokal:

docker build -t imdb-mcp .

Starten Sie den Container:

docker run --rm \
  -p 8080:8080 \
  -e HOST=0.0.0.0 \
  -e PORT=8080 \
  -e WEBUI_PASSWORD=your-secure-password \
  -e WEBUI_SESSION_SECRET=your-secret \
  imdb-mcp

Docker Compose

Alternativ können Sie Docker Compose verwenden, um den Container zu verwalten:

docker-compose up -d

Beispiel docker-compose.yml:

services:
  imdb-mcp:
    image: ghcr.io/danish-mar/imdb-mcp:latest
    ports:
      - "8080:8080"
    environment:
      - WEBUI_PASSWORD=your-password

📁 Projektstruktur

src/
  index.ts       # Entry point & Server initialization
  config.ts      # App configuration & Env loading
  server.ts      # FastMCP instance setup
  tools/         # IMDb tool implementations (Search, Playback, etc.)
  webui/         # Hono routes for the dashboard
  lib/           # Auth & formatting utilities
views/           # EJS templates for the WebUI
.github/         # GitHub Actions workflows for Docker publishing

📝 Hinweise

• Such-Patch: Dieser Server verwendet einen benutzerdefinierten Fallback auf die IMDb-Autocomplete-API, da die standardmäßigen imdb-core GraphQL-Hashes derzeit veraltet sind.

• Authentifizierung: Die meisten Tools sind zustandslos und erfordern keine IMDb-Cookies. Für den Zugriff auf private Listen können Sie die imdbClient-Sitzung in src/tools/index.ts erweitern.

• Wiedergabe: Wiedergabe-URLs verweisen auf Drittanbieter; bitte verantwortungsbewusst nutzen.

Mit ❤️ erstellt unter Verwendung von FastMCP und TypeScript.