tmdb-mcp

MCP-сервер для управления вашими списками TMDB из Claude, Cursor или любого другого MCP-клиента. Работает на Cloudflare Workers; связывает OAuth 2.1 с процессом аутентификации v4 в TMDB, поэтому ваш токен 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)

• Воркер предоставляет стандартный сервер авторизации OAuth 2.1 для MCP-клиентов.

• По адресу /authorize он запрашивает request_token TMDB v4, перенаправляет пользователя на страницу подтверждения TMDB и обменивает одобренный токен на access_token v4 по адресу /callback.

• Токен TMDB хранится только в объекте свойств сессии; клиенты получают непрозрачный токен носителя (bearer), созданный @cloudflare/workers-oauth-provider.

• Все вызовы API TMDB происходят на стороне сервера.

Предварительные требования

• Учетная запись Cloudflare с включенными Workers

• Учетная запись TMDB с API Read Access Token v4 из раздела Settings → API

• Bun

Настройка

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

Создайте свое пространство имен KV и замените id в wrangler.jsonc:

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

Settings → MCP → Add new MCP server, вставьте URL, заканчивающийся на /mcp.

claude.ai (веб)

Settings → Connectors → Add custom connector → вставьте URL /mcp.

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.