bms-mcp
🎬 BookMyShow MCP Webscraper
Python-скрапер и API-обёртка для BookMyShow, которая извлекает списки фильмов, расписания сеансов в кинотеатрах, цены на билеты и данные о местоположении площадок (включая GPS-координаты широты и долготы).
Всё упаковано в FastAPI REST-сервер, MCP-инструменты (для ИИ-ассистентов, таких как Claude или Cursor), CLI-инструмент и встроенную веб-панель.
✨ Возможности
Списки фильмов и событий: Получение активных и предстоящих списков фильмов по городам Индии (Мумбаи, Дели-NCR, Бангалор, Ченнаи и др.) с фильтрами по языку и жанру.
Расписание сеансов и цены: Получение расписания сеансов в кинотеатрах, форматов экрана (2D, 3D, IMAX, 4DX), диапазонов цен на билеты (в ₹) и наличия мест.
Местоположение площадок и координаты: Получение почтовых адресов кинотеатров, точных координат широты и долготы, а также удобств площадки (парковка, фуд-корт, M-ticket вход).
Синопсис и трейлеры фильмов: Получение кратких описаний сюжета, информации об актёрах и съёмочной группе, рейтингов, постеров и ссылок на трейлеры на YouTube.
Работа в качестве MCP-сервера: Работает из коробки с ИИ-инструментами (Claude Desktop, Cursor, Antigravity) через
bms-mcp(илиmcp_server.pyлокально).FastAPI REST-сервер: Интерактивная документация Swagger API (
/docs).Терминальный CLI: Терминальный интерфейс для поиска, списков и экспорта.
Экспорт в файлы: Экспорт собранных данных в JSON, CSV или Excel (
.xlsx).Веб-панель: Простая панель в светлой теме для просмотра фильмов и тестирования конечных точек.
Related MCP server: Movie Booking Assistant
🚀 Быстрый старт и установка
git clone https://github.com/m0han-r/bookmyshow-mcp-webscraper.git
cd bookmyshow-mcp-webscraper
pip install -r requirements.txt🔌 API и MCP-инструменты
REST-конечная точка | Имя MCP-инструмента | Параметры | Описание |
|
|
| Поддерживаемые регионы Индии и популярные города |
|
|
| Активные списки фильмов с фильтрами по языку и жанру |
|
|
| Живые события, комедийные шоу, музыкальные концерты и спорт |
|
|
| Синопсис, актёры, съёмочная группа, рейтинги, постер и ссылки на трейлер |
|
|
| Расписание сеансов, форматы экрана (IMAX/3D/4DX), цены, места и фильтр по языку |
|
|
| Почтовый адрес кинотеатра, точные широта, долгота и удобства |
|
|
| Перекрёстный поиск фильмов и живых событий |
Пример ответа для площадки (GET /api/v1/venues/PCAN?city=chennai):
{
"success": true,
"count": 1,
"data": {
"venue_code": "PCAN",
"venue_name": "PVR: VR Chennai, Anna Nagar",
"address": "3rd Floor, VR Mall, Metro Zone, Jawaharlal Nehru Road, Anna Nagar, Chennai, Tamil Nadu 600040",
"latitude": 13.082561,
"longitude": 80.194803,
"facilities": ["Ticket Cancellation", "F&B", "MTicket", "Parking Facility", "Food Court"]
}
}🌐 Запуск REST API-сервера
Запустите сервер:
python main.pySwagger UI: http://localhost:8000/docs
Веб-панель: http://localhost:8000/
🤖 Настройка MCP-сервера
Подключите свой ИИ-ассистент (Claude Desktop, Cursor, Antigravity) с помощью uvx. uvx автоматически загружает пакет из GitHub и выполняет точку входа скрипта bms-mcp, зарегистрированную в pyproject.toml.
Конфигурация Claude Desktop / Cursor / Antigravity
Добавьте в ваш %APPDATA%\Claude\claude_desktop_config.json (или .cursor/mcp.json):
{
"mcpServers": {
"bookmyshow": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
"bms-mcp"
]
}
}
}Прямое выполнение в терминале
Запустите нативно в PowerShell или Command Prompt (uv генерирует и запускает обёртки bms-mcp.exe на Windows):
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcpКонфигурация Claude Desktop / Cursor / Antigravity
Добавьте в ваш ~/.config/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bookmyshow": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
"bms-mcp"
]
}
}
}Прямое выполнение в терминале
Запустите прямо в терминале Linux:
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcpКонфигурация Claude Desktop / Cursor / Antigravity
Добавьте в ваш ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bookmyshow": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
"bms-mcp"
]
}
}
}Прямое выполнение в терминале
Запустите прямо в терминале macOS / zsh:
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcpЕсли вы клонировали репозиторий локально:
python mcp_server.py🐍 Использование Python
from bms_scraper import BookMyShowScraper
scraper = BookMyShowScraper()
# Get active movies
movies = scraper.get_movies(city="mumbai", language="Hindi")
# Get venue coordinates
venue = scraper.get_venue_details(venue_code_or_url="PCAN", city="chennai")
print(f"📍 {venue.venue_name} - Lat: {venue.latitude}, Lon: {venue.longitude}")
# Get showtimes (supports language filters e.g. "tamil", "hindi", "all" and format filters e.g. "IMAX", "2D")
showtimes = scraper.get_showtimes(movie_code_or_url="ET00378770", city="chennai", date="20260827", language="tamil", format="2D")💻 Использование CLI
Выполняйте CLI напрямую через uvx без установки зависимостей или локально через Python:
# List popular cities via uvx
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli cities --popular
# Scrape movies in Bengaluru and export to Excel
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli movies --city bengaluru --language Hindi --export xlsx
# Scrape showtimes in Chennai for Tamil language with date and export to JSON
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli showtimes --code ET00378770 --city chennai --date 20260827 --language tamil --export json# List popular cities via uvx
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli cities --popular
# Scrape movies in Bengaluru and export to Excel
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli movies --city bengaluru --language Hindi --export xlsx
# Scrape showtimes in Chennai for Tamil language with date and export to JSON
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-cli showtimes --code ET00378770 --city chennai --date 20260827 --language tamil --export json# List popular cities
python -m bms_scraper.cli cities --popular
# Scrape movies in Bengaluru and export to Excel
python -m bms_scraper.cli movies --city bengaluru --language Hindi --export xlsx
# Scrape showtimes with language filter
python -m bms_scraper.cli showtimes --code ET00378770 --city chennai --date 20260827 --language tamil --format 2D📊 Экспорт данных
from bms_scraper import BookMyShowScraper, DataExporter
scraper = BookMyShowScraper()
movies = scraper.get_movies(city="mumbai")
DataExporter.to_csv(movies, "movies.csv")
DataExporter.to_excel(movies, "movies.xlsx")
DataExporter.to_json(movies, "movies.json")🧪 Запуск тестов
python -m pytest⚖️ Лицензия
Распространяется под лицензией MIT.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides a comprehensive movie booking experience for AMC Theatres, enabling users to discover movies, find showtimes, select seats, and process payments through conversational AI. Supports multi-location theater search with real-time seat availability and booking management.61MIT
- FlicenseNot gradedqualityDmaintenanceProvides a suite of tools for searching movies, checking showtimes, and managing ticket bookings for Bangalore cinemas. It enables AI clients to handle end-to-end movie theater interactions including seat availability checks and reservation management.

@qasperai/mcp-serverofficial
AlicenseAqualityCmaintenanceEnables AI assistants to discover and book local service businesses like barbers, plumbers, and mechanics directly through MCP-compatible tools.988MIT- FlicenseNot gradedqualityCmaintenanceEnables searching for movies, checking Google Calendar for conflicts, and booking tickets with seat type and INR pricing, all through natural conversation. Supports demo mode without API keys.
Related MCP Connectors
Live Google Maps business search, review, and photo data for AI agents over MCP.
AI marketplace — flights, tours, activities, transport & more via MCP. No auth required.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/m0han-r/bookmyshow-mcp-webscraper'
If you have feedback or need assistance with the MCP directory API, please join our Discord server