tmdb-mcp

Claude、Cursor、またはその他のMCPクライアントからTMDBリストを管理するためのMCPサーバーです。Cloudflare Workers上で動作し、OAuth 2.1をTMDBのv4認証フローにブリッジするため、TMDBトークンがワーカーから外部に漏れることはありません。

ツール

Related MCP server: Remote MCP Server with Bearer Auth

アーキテクチャ

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

• ワーカーは、MCPクライアントに対して標準的なOAuth 2.1認可サーバーを提供します。

• /authorizeでは、TMDB v4のrequest_tokenを要求し、ユーザーをTMDBの承認ページにリダイレクトし、/callbackで承認されたトークンをv4のaccess_tokenと交換します。

• TMDBトークンはセッションごとのpropsオブジェクト内にのみ保存されます。クライアントは@cloudflare/workers-oauth-providerによって発行された不透明なベアラートークンを受け取ります。

• すべてのTMDB API呼び出しはサーバーサイドで行われます。

前提条件

• Workersが有効なCloudflareアカウント

• 設定 → APIから取得したv4のAPI Read Access Tokenを持つTMDBアカウント

• Bun

セットアップ

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

独自のKV名前空間を作成し、wrangler.jsonc内のidを置き換えてください：

bunx wrangler kv namespace create OAUTH_KV

TMDBアプリケーショントークンをワーカーのシークレットとして設定します：

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

デプロイ：

bun run deploy

ローカル開発の場合は、.dev.vars.exampleを.dev.varsにコピーし、トークンを入力してから以下を実行します：

bun run dev

接続

以下のhttps://your-worker.your-subdomain.workers.devを、デプロイしたURLに置き換えてください。

Claude Code

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

初回使用時にブラウザでOAuthフローを完了するよう求められます。

Cursor

設定 → MCP → 新しいMCPサーバーを追加し、/mcpで終わるURLを貼り付けます。

claude.ai (Web)

設定 → コネクタ → カスタムコネクタを追加 → /mcp URLを貼り付けます。

MCP Inspector

bun run inspector

次に、https://your-worker.your-subdomain.workers.dev/mcp（ストリーミング可能なHTTPトランスポート）を指定します。

トラブルシューティング

• ライブワーカーログのストリーミング: bun run tail

• TMDB request_token failed — TMDB_APP_TOKENシークレットが存在しないか無効です。bunx wrangler secret put TMDB_APP_TOKENでリセットしてください。

• Authorization session expired or unknown — OAuthの往復に10分以上かかったか、ユーザーが別のブラウザセッションで承認リンクを開きました。コネクタを再起動してください。

• claude.ai Webでコネクタの連携が完了しない — 上記の回帰に関する注意書きを参照してください。Claude CodeまたはMCP Inspectorでサーバーを確認してください。

ライセンス

MIT — LICENSEを参照してください。