IMDB MCP Server
IMDB MCP Server
Облачный JSON-RPC-сервис, предоставляющий доступ к данным IMDB. Предназначен для работы с LLM через MCP (Model Context Protocol).
Как это работает
Конфигурация LLM: Добавьте URL MCP-сервера в конфигурацию вашей LLM
Обнаружение: LLM обращается к URL сервера, чтобы понять, какие инструменты доступны
Запрос: LLM отправляет JSON-RPC-запросы для получения данных IMDB
Ответ: Сервер возвращает структурированные данные, которые LLM интерпретирует и объясняет пользователям
Related MCP server: moviefinder-mcp
Эндпоинты
Эндпоинт | Метод | Описание |
| GET | HTML-документация (человекочитаемая) |
| GET | Информация о сервисе (JSON) |
| POST | Эндпоинт JSON-RPC 2.0 |
| POST | Эндпоинт протокола MCP для вызова инструментов LLM |
| GET | Проверка работоспособности для облачных развертываний |
Доступные инструменты
Инструмент | Описание | Параметры |
| Поиск фильмов по названию |
|
| Получение полной информации о фильме |
|
| Поиск актёров и режиссёров |
|
| Информация о человеке и его фильмография |
|
| Получение списка IMDB Top 250 |
|
| Получение актёрского состава фильма |
|
Использование 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:latestGoogle Cloud Run
gcloud run deploy imdb-mcp \
--source . \
--platform managed \
--allow-unauthenticatedAWS 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Переменные окружения
Переменная | По умолчанию | Описание |
| 8080 | Порт сервера |
Примечания
Cinemagoer запрашивает данные IMDB через веб-скрапинг, поэтому ответы могут быть медленнее, чем у решений на основе API
Только для некоммерческого использования (в соответствии с условиями использования IMDB)
API-ключ не требуется
This server cannot be deployed
Maintenance
Related MCP Connectors
OMDb MCP — IMDB-derived movie / TV / episode data (BYO key)
Movie and series ranking as MCP tools: top titles, search, lookup by IMDb id. Free, no key.
Movies MCP — wraps iTunes Search API (movies, free, no auth) and TVmaze API (TV shows, free, no…
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides 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-
- FlicenseAqualityDmaintenanceAn 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-
- AlicenseAqualityCmaintenanceMCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.5MIT
- FlicenseNot gradedqualityDmaintenanceA robust MCP server that wraps The Movie Database API, enabling LLMs to search movies, get details, popular movies, and recommendations.-