bms-mcp
🎬 BookMyShow MCP Webscraper
Ein Python-Scraper und API-Wrapper für BookMyShow, der Filmlisten, Kinovorstellungen, Ticketpreise und Veranstaltungsortdetails (einschließlich GPS-Breiten- und Längengrad) extrahiert.
Es bündelt alles in einem FastAPI-REST-Server, MCP-Werkzeugen (für KI-Assistenten wie Claude oder Cursor), einem CLI-Tool und einem integrierten Web-Dashboard.
✨ Funktionen
Filme & Veranstaltungen auflisten: Ruft aktive oder kommende Filmlisten in indischen Städten (Mumbai, Delhi-NCR, Bengaluru, Chennai usw.) ab, mit Filtern nach Sprache und Genre.
Vorstellungen & Preise abrufen: Holt Kinovorstellungen, Bildschirmformate (2D, 3D, IMAX, 4DX), Ticketpreisspannen (in ₹) und Sitzplatzverfügbarkeit.
Veranstaltungsorte & Breiten-/Längengrad extrahieren: Ruft Straßenadressen von Kinos, genaue Breiten- und Längengradkoordinaten sowie Annehmlichkeiten des Veranstaltungsorts (Parkplatz, Food Court, M-Ticket-Eingang) ab.
Filmsynopsen & Trailer abrufen: Ruft Handlungszusammenfassungen, Besetzungs- und Crew-Informationen, Bewertungen, Poster und YouTube-Trailer-Links ab.
Als MCP-Server ausführbar: Funktioniert sofort mit KI-Tools (Claude Desktop, Cursor, Antigravity) über
bms-mcp(oder lokalmcp_server.py).FastAPI-REST-Server: Interaktive Swagger-API-Dokumentation (
/docs).Terminal-CLI: Terminal-Schnittstelle für Suche, Auflistungen und Exporte.
Export in Dateien: Exportiert gescrapte Daten als JSON, CSV oder Excel (
.xlsx).Web-Dashboard: Einfaches Dashboard mit hellem Design zum Durchsuchen von Filmen und Testen von Endpunkten.
Related MCP server: Movie Booking Assistant
🚀 Schnellstart & Installation
git clone https://github.com/m0han-r/bookmyshow-mcp-webscraper.git
cd bookmyshow-mcp-webscraper
pip install -r requirements.txt🔌 API & MCP-Werkzeuge
REST-Endpunkt | MCP-Werkzeugname | Parameter | Beschreibung |
|
|
| Unterstützte indische Regionen & beliebte Städte |
|
|
| Aktive Filmlisten mit Sprach-/Genre-Filtern |
|
|
| Live-Veranstaltungen, Comedy-Shows, Musikkonzerte und Sport |
|
|
| Synopse, Besetzung, Crew, Bewertungen, Poster- & Trailer-Links |
|
|
| Vorstellungen, Bildschirmformate (IMAX/3D/4DX), Preise, Sitzplätze & Sprachfilterung |
|
|
| Straßenadresse des Kinos, genaue Breite, Länge & Einrichtungen |
|
|
| Quersuche nach Filmen und Live-Veranstaltungen |
Beispiel-Antwort für Veranstaltungsort (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"]
}
}🌐 Starten des REST-API-Servers
Starten Sie den Server:
python main.pySwagger UI: http://localhost:8000/docs
Web-Dashboard: http://localhost:8000/
🤖 MCP-Server-Einrichtung
Verbinden Sie Ihren KI-Assistenten (Claude Desktop, Cursor, Antigravity) mit uvx. uvx holt das Paket automatisch von GitHub und führt den in pyproject.toml registrierten Skript-Einstiegspunkt bms-mcp aus.
Claude Desktop / Cursor / Antigravity-Konfiguration
Fügen Sie zu Ihrer %APPDATA%\Claude\claude_desktop_config.json (oder .cursor/mcp.json) hinzu:
{
"mcpServers": {
"bookmyshow": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
"bms-mcp"
]
}
}
}Direkte Terminal-Ausführung
Führen Sie nativ in PowerShell oder Command Prompt aus (uv generiert und führt bms-mcp.exe-Wrapper unter Windows aus):
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcpClaude Desktop / Cursor / Antigravity-Konfiguration
Fügen Sie zu Ihrer ~/.config/Claude/claude_desktop_config.json hinzu:
{
"mcpServers": {
"bookmyshow": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
"bms-mcp"
]
}
}
}Direkte Terminal-Ausführung
Führen Sie direkt im Linux-Terminal aus:
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcpClaude Desktop / Cursor / Antigravity-Konfiguration
Fügen Sie zu Ihrer ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:
{
"mcpServers": {
"bookmyshow": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git",
"bms-mcp"
]
}
}
}Direkte Terminal-Ausführung
Führen Sie direkt im macOS-Terminal / zsh aus:
uvx --from git+https://github.com/m0han-r/bookmyshow-mcp-webscraper.git bms-mcpWenn Sie das Repository lokal geklont haben:
python mcp_server.py🐍 Python-Nutzung
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-Nutzung
Führen Sie die CLI direkt über uvx aus, ohne Abhängigkeiten zu installieren, oder lokal über 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📊 Exportieren von Daten
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")🧪 Ausführen von Tests
python -m pytest⚖️ Lizenz
Verteilt unter der MIT-Lizenz.
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