moviefinder-mcp

MCP-сервер, который оборачивает API TMDB, чтобы MCP-совместимый клиент (Claude Desktop, Claude Code и т. д.) мог искать фильмы и сериалы, просматривать подробности, узнавать, что сейчас в тренде, получать рекомендации и проверять, где доступен просмотр того или иного контента.

Инструменты

Инструмент	Описание
`search_movies`	Поиск фильмов по названию; опционально `year`.
`search_tv`	Поиск сериалов по названию.
`get_movie_details`	Подробности о фильме, включая актерский состав, режиссера и URL трейлера.
`get_recommendations`	Рекомендации TMDB для ID фильма.
`get_similar`	Фильмы, похожие на фильм с указанным ID.
`get_trending`	Тренды: `movie` / `tv` / `all` за `day` или `week`.
`where_to_stream`	Провайдеры просмотра (стриминг / аренда / покупка) по стране (по умолчанию `US`).
`discover_movies`	Поиск по названию `genre`, `min_rating`, `year`, `sort_by`.

Все инструменты возвращают сокращенный JSON (id, название, год, описание, рейтинг, URL постера, плюс специфичные для инструмента поля) вместо «сырых» данных TMDB.

Настройка

Требования: Node 20+.

npm install
cp .env.example .env
# edit .env and paste your TMDB v4 read access token
npm run build
npm start    # runs the compiled server over stdio

Получение API-ключа TMDB

Создайте учетную запись TMDB на сайте https://www.themoviedb.org/.
Откройте https://www.themoviedb.org/settings/api.
Скопируйте API Read Access Token (v4 auth) — не API-ключ v3.
Добавьте его в файл .env как TMDB_API_KEY=....

Сервер отправляет его в заголовке Authorization: Bearer <token>.

Регистрация в Claude Desktop

Отредактируйте claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "moviefinder": {
      "command": "node",
      "args": ["/absolute/path/to/moviefinder-mcp/dist/index.js"],
      "env": {
        "TMDB_API_KEY": "your_v4_read_access_token_here"
      }
    }
  }
}

Перезапустите Claude Desktop. Указанные выше инструменты появятся в сервере moviefinder.

Примечания

Список жанров (/genre/movie/list) загружается один раз и кэшируется в памяти для discover_movies.
Ответы 401 / 404 / 429 сопровождаются понятными сообщениями.
Входные данные проверяются с помощью zod перед любым вызовом TMDB.