IMDb MCP Server 🎬

Мощный сервер Model Context Protocol (MCP) для поиска, обнаружения и воспроизведения контента с IMDb. Построенный на базе FastMCP, этот сервер обеспечивает надежный мост между LLM и метаданными фильмов, включая собственный слой воспроизведения и современную веб-панель управления.

✨ Возможности

🚀 Движок FastMCP: Высокопроизводительная реализация MCP поверх потокового HTTP.
🔍 Интеллектуальный поиск: Исправленная логика поиска с использованием API автодополнения IMDb для надежного поиска названий без аутентификации.
📺 Слой воспроизведения: Прямая интеграция с playimdb.com для получения мгновенных ссылок на потоковое вещание.
📊 Панель мониторинга: Защищенный паролем веб-интерфейс для мониторинга метрик, инструментов и состояния системы в режиме реального времени.
🐳 Готовность к Docker: Оптимизированный многоэтапный Dockerfile для простого развертывания.
🤖 GitHub Actions: Автоматизированный CI/CD рабочий процесс для сборки и отправки образов в GHCR при выпуске релизов.

🛠️ Включенные инструменты

Инструмент	Описание
`imdb_search_title`	Поиск фильмов, сериалов или игр. Возвращает чистые метаданные, включая ID.
`imdb_get_public_list_items`	Получение всех элементов из любого публичного списка IMDb по его ID.
`play_movie`	Генерирует прямую ссылку на потоковое вещание `playimdb.com` для заданного ID IMDb.
`search_and_play`	Ультимативный инструмент: Ищет название и возвращает URL для воспроизведения + полные детали за один вызов.

🚀 Быстрый старт

1. Установка зависимостей

npm install

2. Настройка окружения

cp .env.example .env

Отредактируйте .env, чтобы установить ваш WEBUI_PASSWORD.

3. Запуск сервера разработки

npm run dev

🌐 Эндпоинты

MCP Endpoint: http://127.0.0.1:8080/mcp
Панель управления: http://127.0.0.1:8080/dashboard
Проверка состояния: http://127.0.0.1:8080/health

🐳 Развертывание в Docker

Соберите образ локально:

docker build -t imdb-mcp .

Запустите контейнер:

docker run --rm \
  -p 8080:8080 \
  -e HOST=0.0.0.0 \
  -e PORT=8080 \
  -e WEBUI_PASSWORD=your-secure-password \
  -e WEBUI_SESSION_SECRET=your-secret \
  imdb-mcp

Docker Compose

Альтернативно используйте Docker Compose для управления контейнером:

docker-compose up -d

Пример docker-compose.yml:

services:
  imdb-mcp:
    image: ghcr.io/danish-mar/imdb-mcp:latest
    ports:
      - "8080:8080"
    environment:
      - WEBUI_PASSWORD=your-password

📁 Структура проекта

src/
  index.ts       # Entry point & Server initialization
  config.ts      # App configuration & Env loading
  server.ts      # FastMCP instance setup
  tools/         # IMDb tool implementations (Search, Playback, etc.)
  webui/         # Hono routes for the dashboard
  lib/           # Auth & formatting utilities
views/           # EJS templates for the WebUI
.github/         # GitHub Actions workflows for Docker publishing

📝 Примечания

Исправление поиска: Этот сервер использует собственный механизм отката к API автодополнения IMDb, так как стандартные GraphQL-хэши imdb-core в настоящее время устарели.
Аутентификация: Большинство инструментов не имеют состояния и не требуют файлов cookie IMDb. Для доступа к приватным спискам вы можете расширить сессию imdbClient в src/tools/index.ts.
Воспроизведение: URL-адреса воспроизведения указывают на сторонних провайдеров; используйте их ответственно.

Создано с ❤️ с использованием FastMCP и TypeScript.

IMDb MCP Server