tmdb-mcp

Ein MCP-Server zur Verwaltung Ihrer TMDB-Listen von Claude, Cursor oder jedem anderen MCP-Client aus. Läuft auf Cloudflare Workers; überbrückt OAuth 2.1 zum v4-Authentifizierungs-Flow von TMDB, sodass Ihr TMDB-Token den Worker niemals verlässt.

Tools

Related MCP server: Remote MCP Server with Bearer Auth

Architektur

[MCP client]  ──OAuth 2.1──  [Worker]  ──TMDB v4 auth──  [themoviedb.org]
                                │
                                ├── KV  (oauth state, opaque tokens)
                                └── Durable Object  (per-session MCP agent)

• Der Worker stellt MCP-Clients einen standardmäßigen OAuth 2.1-Autorisierungsserver bereit.

• Unter /authorize fordert er ein TMDB v4 request_token an, leitet den Benutzer zur Genehmigungsseite von TMDB weiter und tauscht das genehmigte Token unter /callback gegen ein v4 access_token ein.

• Das TMDB-Token wird nur im pro-Sitzung-Props-Objekt gespeichert; Clients erhalten einen opaken Bearer-Token, der von @cloudflare/workers-oauth-provider erstellt wurde.

• Alle TMDB-API-Aufrufe erfolgen serverseitig.

Voraussetzungen

• Ein Cloudflare-Konto mit aktivierten Workers

• Ein TMDB-Konto mit einem v4 API Read Access Token aus Einstellungen → API

• Bun

Einrichtung

git clone https://github.com/dendotai/tmdb-mcp.git
cd tmdb-mcp
bun install

Erstellen Sie Ihren eigenen KV-Namespace und ersetzen Sie die id in wrangler.jsonc:

bunx wrangler kv namespace create OAUTH_KV

Setzen Sie das TMDB-Anwendungstoken als Worker-Geheimnis:

bunx wrangler secret put TMDB_APP_TOKEN
# paste your v4 API Read Access Token

Bereitstellen:

bun run deploy

Für die lokale Entwicklung kopieren Sie .dev.vars.example nach .dev.vars, tragen Sie das Token ein und führen Sie dann Folgendes aus:

bun run dev

Verbinden

Ersetzen Sie https://your-worker.your-subdomain.workers.dev unten durch Ihre bereitgestellte URL.

Claude Code

claude mcp add --transport http tmdb https://your-worker.your-subdomain.workers.dev/mcp

Sie werden bei der ersten Verwendung aufgefordert, den OAuth-Flow in Ihrem Browser abzuschließen.

Cursor

Einstellungen → MCP → Neuen MCP-Server hinzufügen, die URL, die auf /mcp endet, einfügen.

claude.ai (Web)

Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → die /mcp-URL einfügen.

MCP Inspector

bun run inspector

Zeigen Sie dann auf https://your-worker.your-subdomain.workers.dev/mcp (Streamable HTTP Transport).

Fehlerbehebung

• Den Live-Worker-Log streamen: bun run tail

• TMDB request_token failed — Ihr TMDB_APP_TOKEN-Geheimnis fehlt oder ist ungültig. Setzen Sie es mit bunx wrangler secret put TMDB_APP_TOKEN zurück.

• Authorization session expired or unknown — der OAuth-Roundtrip hat länger als 10 Minuten gedauert oder der Benutzer hat den Genehmigungslink in einer anderen Browsersitzung geöffnet. Starten Sie den Connector neu.

• claude.ai Web schließt den Connector-Vorgang nicht ab — siehe den Hinweis zur Regression oben; überprüfen Sie den Server mit Claude Code oder dem MCP Inspector.

Lizenz

MIT — siehe LICENSE.