MCP-сервер TMDB

Этот сервер MCP интегрируется с API The Movie Database (TMDB) для предоставления информации о фильмах, возможностей поиска и рекомендаций.

Предпосылки

Перед установкой и запуском сервера TMDB MCP убедитесь, что установлены и настроены следующие обязательные компоненты:

Необходимое программное обеспечение

• Node.js

  • Версия 18.0.0 или выше

  • Загрузить с официального сайта Node.js

  • Проверьте установку: node --version

• npm (менеджер пакетов узлов)

  • Версия 8.0.0 или выше (входит в состав Node.js)

  • Проверьте установку: npm --version

• Машинопись

  • Будет установлен как зависимость проекта

  • Можно установить глобально: npm install -g typescript

  • Проверьте установку: tsc --version

Необходимые учетные записи и ключи API

• Счет TMDB

  • Бесплатная учетная запись на TMDB

  • API-ключ из панели управления TMDB

  • Доступ к API должен быть одобрен TMDB

• Приложение Клода для рабочего стола

  • Установлена последняя версия

  • Доступ для изменения файлов конфигурации

Системные требования

• Операционные системы

  • macOS (10.15 или более поздняя версия)

  • Linux (современные дистрибутивы)

• Требования к оборудованию

  • Минимум 4 ГБ ОЗУ

  • 1 ГБ свободного места на диске

  • Стабильное интернет-соединение

Среда разработки

Для лучшего опыта разработки мы рекомендуем:

• Редактор кода с поддержкой TypeScript (например, VS Code)

• Терминальный доступ

• Git (для контроля версий)

Функции

Инструменты

• поиск_фильмов

  • Поиск фильмов по названию или ключевым словам

  • Ввод: query (строка): Поисковый запрос

  • Возвращает: список фильмов с названиями, годами выпуска, идентификаторами, рейтингами и обзорами.

  • Пример: Поиск фильмов об исследовании космоса.

• получить_рекомендации

  • Получайте рекомендации фильмов на основе идентификатора фильма

  • Ввод: movieId (строка): идентификатор фильма TMDB

  • Возвращает: 5 лучших рекомендуемых фильмов с подробностями

  • Пример: получите рекомендации на основе идентификатора фильма 550 (Бойцовский клуб)

• получить_тренд

  • Получите популярные фильмы за указанный промежуток времени

  • Ввод: timeWindow (строка): «день» или «неделя»

  • Возвращение: 10 самых популярных фильмов с подробностями

  • Пример: Получите сегодняшние популярные фильмы

Ресурсы

Сервер предоставляет доступ к информации о фильмах TMDB:

• Фильмы ( tmdb:///movie/<movie_id> )

  • Подробная информация о фильме, включая:

    • Название и дата выпуска

    • Рейтинг и обзор

    • Жанры

    • URL-адрес постера

    • Информация об актерском составе (топ-5 актеров)

    • Директор

    • Избранные обзоры

  • Все данные возвращаются в формате JSON.

Начиная

1. Получите ключ API TMDB:

   • Зарегистрируйтесь на TMDB

   • Перейдите в настройки вашего аккаунта.

   • Перейдите в раздел API

   • Запросите ключ API для использования разработчиком

2. Клонируйте и настройте проект:

   git clone [repository-url] cd mcp-server-tmdb npm install

3. Сборка сервера:

   npm run build

4. Настройте переменную среды:

   export TMDB_API_KEY=your_api_key_here

Использование с Claude Desktop

Чтобы интегрировать этот сервер с Claude Desktop, добавьте следующее в файл конфигурации сервера вашего приложения (расположенный по адресу ~/Library/Application Support/Claude/config.json ):

Замените /full/path/to на фактический путь к каталогу вашего проекта.

Установка через Smithery

Чтобы автоматически установить TMDB Server для Claude Desktop через Smithery :

Пример использования

После запуска сервера с Claude Desktop вы можете использовать такие команды:

1. Поиск фильмов:

   "Search for movies about artificial intelligence"

2. Получите популярные фильмы:

   "What are the trending movies today?" "Show me this week's trending movies"

3. Получить рекомендации фильмов:

   "Get movie recommendations based on movie ID 550"

4. Получить информацию о фильме:

   "Tell me about the movie with ID 550"

Обработка ошибок

Сервер включает в себя комплексную обработку ошибок для:

• Недействительные ключи API

• Ошибки сети

• Недействительные идентификаторы фильмов

• Неправильно сформированные запросы

Сообщения об ошибках будут возвращаться в удобном для пользователя формате через Claude Desktop.

Разработка

Чтобы отслеживать изменения в процессе разработки:

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Подробности см. в файле LICENSE.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.