moviecom-mcp

Servidor MCP (Model Context Protocol) para consultar programação de filmes e disponibilidade de assentos da Moviecom.

Objetivo do projeto

Este projeto expõe ferramentas MCP para:

• Buscar a programação de filmes em cartaz.
• Consultar assentos disponíveis de uma sessão específica.
• Listar filmes e enriquecer cada sessão com dados de disponibilidade.

Com isso, clientes MCP (como assistentes e integrações) conseguem consumir esses dados de forma estruturada via stdio.

Pré-requisitos

• Node.js 18+ (recomendado 20+).
• npm.

Instalação

1. Clone o repositório:

git clone git@github.com:Santosl2/moviecom-mcp.git
cd moviecom-mcp

2. Instale as dependências:

npm install

Como usar

1) Executar o servidor MCP

Este projeto roda como servidor MCP em stdio.

node src/server.js

Observação: no estado atual do projeto, prefira o comando acima (o script npm start aponta para server.js na raiz).

2) Ferramentas disponíveis

O servidor registra as seguintes tools:

1. moviecom_programming

• Retorna a programação de filmes.
• Input:

{
	"date": "2026-07-30"
}

2. moviecom_available_seats

• Retorna assentos disponíveis de uma sessão.
• Input:

{
	"sessionId": "11f18ab7ae7ca66580e69ae9bbbc5a12"
}

3. moviecom_movies

• Retorna filmes e tenta anexar disponibilidade de assentos em cada sessão.
• Input:

{
	"date": "2026-07-30"
}

3) Exemplo de saída (resumido)

[
	{
		"title": "A Odisseia",
		"classification": "14",
		"duration": "172 minutos  ·  Ação, Fantasia",
		"image": "https://...jpg",
		"programations": [
			{
				"type": "DUB",
				"room": "Sala 1",
				"hour": "18:00",
				"url": "https://moviecom.com.br/vendasessao/?idprog=...",
				"chairs": {
					"total": 152,
					"available": 19,
					"occupied": 130,
					"blocked": 3,
					"seats": [
						{
							"id": "A17",
							"name": "A17",
							"row": 1,
							"column": 17,
							"sector": null,
							"kind": null
						}
					]
				}
			}
		]
	}
]

Estrutura do projeto

src/
	functions.js   # parsing e coleta de dados
	server.js      # servidor MCP e registro das tools
moviecom.json    # exemplo de payload/resultado

Tecnologias

• @modelcontextprotocol/server
• cheerio
• zod

Observações

• As consultas dependem dos endpoints externos da Moviecom/VeloxTickets.
• Se a estrutura HTML/endpoint mudar, o parser pode precisar de ajustes.