TMDB MCP Server — MCP-сервер для Claude Code: обзор и установка
Ищет фильмы, сериалы и персон через базу TMDB, а также подтягивает оценки IMDb и Rotten Tomatoes. Пригодится для киноподборок и каталогизации прямо в чате с моделью.
claude mcp add --env TMDB_API_TOKEN=<TMDB_API_TOKEN> --env OMDB_API_KEY=<OMDB_API_KEY> --env TMDB_LANGUAGE=<TMDB_LANGUAGE> --env TMDB_REGION=<TMDB_REGION> --transport stdio tmdb-mcp-server -- npx -y tmdb-mcpЧто делает TMDB MCP Server
Сервер подключается по stdio. Он передаёт модели функции для работы с базой The Movie Database: поиск проектов, биографий актёров, фильмографий и трендов за сутки или неделю. Инструмент get_movies умеет возвращать краткие карточки сразу для группы от 1 до 20 фильмов за одно обращение.
При настройке внешнего API сервис объединяет данные TMDB с рецензиями критиков и пользовательскими баллами. Модель видит рейтинги Rotten Tomatoes, IMDb и Metacritic в едином ответе. Инструменты выборки позволяют искать ленты по диапазону дат, жанрам, компании-производителю и возрастным рейтингам.
Для запуска обязателен токен TMDB_API_TOKEN v4 Read Access Token. Запросы без него закончатся ошибкой. Ключ OMDB_API_KEY, код языка и региональные параметры не требуются для старта, но нужны для локализации описаний и загрузки сторонних рейтингов.
Какие задачи решает
- найти фильмографию конкретного режиссёра или актёра
- сопоставить оценки критиков и зрителей на IMDb, Metacritic и Rotten Tomatoes
- подобрать похожие фильмы или сериалы по рекомендациям TMDB
- отфильтровать картины по годам выхода, жанрам и съёмочной группе
Примеры запросов агенту
- Найди фильм Дюна 2 и покажи хронометраж, жанры и краткий сюжет.
- Сравни оценки критиков для Барби и Оппенгеймера на Rotten Tomatoes и Metacritic.
- Какие детективные сериалы похожи на Настоящий детектив?
Как установить TMDB MCP Server
Командой платформы
claude mcp add --env TMDB_API_TOKEN=<TMDB_API_TOKEN> --env OMDB_API_KEY=<OMDB_API_KEY> --env TMDB_LANGUAGE=<TMDB_LANGUAGE> --env TMDB_REGION=<TMDB_REGION> --transport stdio tmdb-mcp-server -- npx -y tmdb-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add tmdb-mcp-server --env TMDB_API_TOKEN=<TMDB_API_TOKEN> --env OMDB_API_KEY=<OMDB_API_KEY> --env TMDB_LANGUAGE=<TMDB_LANGUAGE> --env TMDB_REGION=<TMDB_REGION> -- npx -y tmdb-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"tmdb-mcp-server": {
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
"OMDB_API_KEY": "<OMDB_API_KEY>",
"TMDB_LANGUAGE": "<TMDB_LANGUAGE>",
"TMDB_REGION": "<TMDB_REGION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"tmdb-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tmdb-mcp"
],
"env": {
"TMDB_API_TOKEN": "<TMDB_API_TOKEN>",
"OMDB_API_KEY": "<OMDB_API_KEY>",
"TMDB_LANGUAGE": "<TMDB_LANGUAGE>",
"TMDB_REGION": "<TMDB_REGION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TMDB_API_TOKEN=<TMDB_API_TOKEN> -e OMDB_API_KEY=<OMDB_API_KEY> -e TMDB_LANGUAGE=<TMDB_LANGUAGE> -e TMDB_REGION=<TMDB_REGION> tmdb-mcp-server npx -y tmdb-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о TMDB MCP Server
Как установить TMDB MCP Server в Claude Code?
Выполните команду claude mcp add tmdb-mcp -e TMDB_API_TOKEN=<TMDB_API_TOKEN> -e OMDB_API_KEY=<OMDB_API_KEY> -- npx -y tmdb-mcp. Подставьте свой токен TMDB и ключ OMDb.
Зачем нужен ключ OMDb?
Сам сервис TMDB не хранит рейтинги сторонних агрегаторов. Переменная OMDB_API_KEY подтягивает оценки с IMDb, Rotten Tomatoes и Metacritic к карточке фильма.
Можно ли получать описания фильмов на русском языке?
Да, для этого при запуске передаётся переменная окружения TMDB_LANGUAGE=ru-RU. Региональные сертификаты и возрастные ограничения настраиваются через параметр TMDB_REGION.
