IMDb MCP Server 🎬

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

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

• 🚀 Движок FastMCP: Высокопроизводительная реализация MCP поверх потокового HTTP.

• 🔍 Интеллектуальный поиск: Исправленная логика поиска с использованием API автодополнения IMDb для надежного поиска названий без аутентификации.

• 📺 Слой воспроизведения: Прямая интеграция с playimdb.com для получения мгновенных ссылок на потоковое вещание.

• 📊 Панель мониторинга: Защищенный паролем веб-интерфейс для мониторинга метрик, инструментов и состояния системы в режиме реального времени.

• 🐳 Готовность к Docker: Оптимизированный многоэтапный Dockerfile для простого развертывания.

• 🤖 GitHub Actions: Автоматизированный CI/CD рабочий процесс для сборки и отправки образов в GHCR при выпуске релизов.

Related MCP server: Movie MCP Server

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

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

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.