Which integrations are available for this server?

Enables searching for movies by title and retrieving cinema showtimes with details on theaters, formats (VF, VOST, 3D, IMAX), and screening times based on location or postal code.

How do I use Allociné MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Allociné MCP Server search for Dune showtimes in Paris this weekend" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Allociné MCP Server

Ce serveur MCP (Model Context Protocol) permet de récupérer des informations sur les films et les séances de cinéma depuis Allociné.

Fonctionnalités

Recherche de films : Trouvez l'ID Allociné d'un film à partir de son titre.
Récupération des séances sur plusieurs jours : Obtenez les horaires, cinémas et formats (VF, VOST, 3D, IMAX) pour un film donné dans une ville ou un code postal spécifique.

Installation et Utilisation

Prérequis

Node.js installé (v16 ou supérieur recommandé).

Installation

Clonez ce dépôt ou copiez les fichiers.
Installez les dépendances :
npm install
Compilez le projet :
npm run build

Configuration pour un Client MCP (ex: Claude Desktop)

Ajoutez la configuration suivante à votre fichier de paramètres MCP :

{ "mcpServers": { "allocine": { "command": "node", "args": ["/chemin/vers/allocine-mcp-server/build/index.js"] } } }

Outils Disponibles

`search_movies`

Recherche un film par titre.

query (string): Titre du film (ex: "Dune", "Le Parrain").

`get_movies_now_showing`

Récupère la liste des films actuellement à l'affiche.

max_pages (number, optionnel): Nombre de pages à charger (environ 15 films par page, défaut: 10).

`search_cinemas`

Recherche un cinéma par nom ou ville.

query (string): Nom du cinéma ou ville.

`get_showtimes`

Récupère les séances pour un film et un lieu.

movie_id (string): L'ID du film (obtenu via search_movies).
location (string): Code postal (ex: "75001") ou nom de ville (ex: "Lyon").
date (string, optionnel): Date cible (YYYY-MM-DD ou DD/MM/YYYY). Si renseignée, seules les séances de ce jour sont récupérées.
Les séances sont renvoyées sur plusieurs jours par défaut, chaque horaire peut inclure un champ date.

`get_cinema_showtimes`

Récupère la programmation complète d'un cinéma.

cinema_id (string): L'ID Allociné du cinéma (ex: C0013).
date (string, optionnel): Date cible (YYYY-MM-DD ou DD/MM/YYYY). Si renseignée, seule cette journée est récupérée.

`get_cinemas_by_card`

Liste les cinémas acceptant une carte spécifique.

card_type (string): ugc (UGC Illimité) ou pathe (Pathé Cinépass).
location (string, optionnel): Code postal ou ville (défaut: Saint-Denis).

`get_movie_booking_links`

Récupère les liens de réservation pour un film dans un cinéma donné.

movie_id (string): L'ID Allociné du film.
cinema_id (string): L'ID Allociné du cinéma.

Note sur le Scraping

Ce serveur utilise le scraping de pages HTML via axios et cheerio. Il est dépendant de la structure du site Allociné. Si le site change, le serveur peut nécessiter une mise à jour.