MCP-сервер TMDB
Этот сервер MCP интегрируется с API The Movie Database (TMDB) для предоставления информации о фильмах, возможностей поиска и рекомендаций.
Предпосылки
Перед установкой и запуском сервера TMDB MCP убедитесь, что установлены и настроены следующие обязательные компоненты:
Необходимое программное обеспечение
- Node.js
- 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.
Начиная
- Получите ключ API TMDB:
- Зарегистрируйтесь на TMDB
- Перейдите в настройки вашего аккаунта.
- Перейдите в раздел API
- Запросите ключ API для использования разработчиком
- Клонируйте и настройте проект:
git clone [repository-url]
cd mcp-server-tmdb
npm install
- Сборка сервера:
- Настройте переменную среды:
export TMDB_API_KEY=your_api_key_here
Использование с Claude Desktop
Чтобы интегрировать этот сервер с Claude Desktop, добавьте следующее в файл конфигурации сервера вашего приложения (расположенный по адресу ~/Library/Application Support/Claude/config.json ):
{
"mcpServers": {
"tmdb": {
"command": "/full/path/to/dist/index.js",
"env": {
"TMDB_API_KEY": "your_api_key_here"
}
}
}
}
Замените /full/path/to на фактический путь к каталогу вашего проекта.
Установка через Smithery
Чтобы автоматически установить TMDB Server для Claude Desktop через Smithery :
npx -y @smithery/cli install @Laksh-star/mcp-server-tmdb --client claude
Пример использования
После запуска сервера с Claude Desktop вы можете использовать такие команды:
- Поиск фильмов:
"Search for movies about artificial intelligence"
- Получите популярные фильмы:
"What are the trending movies today?"
"Show me this week's trending movies"
- Получить рекомендации фильмов:
"Get movie recommendations based on movie ID 550"
- Получить информацию о фильме:
"Tell me about the movie with ID 550"
Обработка ошибок
Сервер включает в себя комплексную обработку ошибок для:
- Недействительные ключи API
- Ошибки сети
- Недействительные идентификаторы фильмов
- Неправильно сформированные запросы
Сообщения об ошибках будут возвращаться в удобном для пользователя формате через Claude Desktop.
Разработка
Чтобы отслеживать изменения в процессе разработки:
Лицензия
Этот сервер MCP лицензирован по лицензии MIT. Подробности см. в файле LICENSE.
Внося вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.