Skip to main content
Glama
Adarsh2001-dot

IMDB MCP Server

IMDB MCP Server

Облачный JSON-RPC-сервис, предоставляющий доступ к данным IMDB. Предназначен для работы с LLM через MCP (Model Context Protocol).

Как это работает

  1. Конфигурация LLM: Добавьте URL MCP-сервера в конфигурацию вашей LLM

  2. Обнаружение: LLM обращается к URL сервера, чтобы понять, какие инструменты доступны

  3. Запрос: LLM отправляет JSON-RPC-запросы для получения данных IMDB

  4. Ответ: Сервер возвращает структурированные данные, которые LLM интерпретирует и объясняет пользователям

Related MCP server: moviefinder-mcp

Эндпоинты

Эндпоинт

Метод

Описание

/

GET

HTML-документация (человекочитаемая)

/info

GET

Информация о сервисе (JSON)

/jsonrpc

POST

Эндпоинт JSON-RPC 2.0

/mcp

POST

Эндпоинт протокола MCP для вызова инструментов LLM

/health

GET

Проверка работоспособности для облачных развертываний

Доступные инструменты

Инструмент

Описание

Параметры

search_movies

Поиск фильмов по названию

query, limit

get_movie_details

Получение полной информации о фильме

movie_id

search_people

Поиск актёров и режиссёров

query, limit

get_person_details

Информация о человеке и его фильмография

person_id

get_top_250_movies

Получение списка IMDB Top 250

limit

get_movie_cast

Получение актёрского состава фильма

movie_id, limit

Использование JSON-RPC

Отправьте POST-запрос на /jsonrpc:

{
    "jsonrpc": "2.0",
    "method": "search_movies",
    "params": {"query": "The Matrix", "limit": 5},
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": [
        {"id": "0133093", "title": "The Matrix", "year": 1999},
        {"id": "0234215", "title": "The Matrix Reloaded", "year": 2003}
    ],
    "id": 1
}

Конфигурация MCP для LLM

Добавьте в конфигурацию MCP-сервера вашей LLM:

{
    "mcpServers": {
        "imdb": {
            "url": "https://your-deployed-url.com/mcp",
            "transport": "http"
        }
    }
}

Локальная разработка

Запуск локально

pip install -r requirements.txt
python app.py

Сервер работает по адресу http://localhost:8080

Запуск с Docker

docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcp

Облачное развертывание

Cloud Foundry

cf push

Использует конфигурацию manifest.yaml.

SAP BTP (Cloud Foundry)

# Build MTA archive
mbt build

# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtar

Использует конфигурацию mta.yaml.

Heroku

heroku create imdb-mcp-server
git push heroku main

Использует Procfile и runtime.txt.

Docker (любое облако)

# Build
docker build -t imdb-mcp .

# Run
docker run -p 8080:8080 imdb-mcp

# Push to registry
docker tag imdb-mcp your-registry/imdb-mcp:latest
docker push your-registry/imdb-mcp:latest

Google Cloud Run

gcloud run deploy imdb-mcp \
    --source . \
    --platform managed \
    --allow-unauthenticated

AWS App Runner / ECS

Используйте Dockerfile с выбранным вами контейнерным сервисом AWS.

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

imdb-mcp/
├── app.py              # FastAPI JSON-RPC server
├── imdb_backend.py     # Cinemagoer wrapper
├── server.py           # FastMCP server (for local MCP)
├── requirements.txt    # Python dependencies
├── pyproject.toml      # Project metadata
├── Dockerfile          # Container image
├── Procfile            # Heroku/PaaS process file
├── runtime.txt         # Python version
├── manifest.yaml       # Cloud Foundry manifest
├── mta.yaml            # SAP BTP MTA descriptor
├── .dockerignore       # Docker ignore patterns
└── .cfignore           # Cloud Foundry ignore patterns

Переменные окружения

Переменная

По умолчанию

Описание

PORT

8080

Порт сервера

Примечания

  • Cinemagoer запрашивает данные IMDB через веб-скрапинг, поэтому ответы могут быть медленнее, чем у решений на основе API

  • Только для некоммерческого использования (в соответствии с условиями использования IMDB)

  • API-ключ не требуется

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides access to IMDB movie and person data, including searches, cast details, and top-rated lists through the Model Context Protocol. It enables LLMs to fetch structured cinematic metadata and filmographies using the Cinemagoer backend.
    1
    -
  • F
    license
    A
    quality
    D
    maintenance
    An MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.
    8
    -
  • A
    license
    A
    quality
    C
    maintenance
    MCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.
    5
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    A robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.
    -