Cezzis.com Cocktails MCP Server

Part of the broader Cezzis.com digital experience for discovering and sharing cocktail recipes with a broad community of cocktail enthusiasts and aficionados.

An MCP (Model Context Protocol) server that gives AI agents secure, first‑class access to Cezzis.com cocktail data. It provides high‑level tools for searching cocktails, retrieving detailed recipes and metadata, authenticating users, and submitting ratings. The server runs over HTTP only and exposes a streamable MCP endpoint.

🧩 Cezzis.com Project Ecosystem

This server works alongside several sibling repositories:

• cocktails-mcp (this repo) – Model Context Protocol services that expose cocktail data to AI agents
• cocktails-api – ASP.NET Core backend and REST API consumed by the site and integrations
• cocktails-web – React SPA for the public experience
• cocktails-common – Shared libraries and utilities reused across frontends, APIs, and tooling
• cocktails-images (private) – Source of curated cocktail imagery and CDN assets
• cocktails-shared-infra – Terraform compositions specific to the cocktails platform
• shared-infrastructure – Global Terraform modules that underpin multiple Cezzis.com workloads

☁️ Cloud-Native Footprint (Azure)

Infrastructure is provisioned with Terraform (/terraform) and deployed into Azure using shared modules:

• Azure Container Apps – Hosts the MCP service (HTTP mode) with HTTPS ingress
• Azure API Management – Optional façade when exposing HTTP endpoints; routes and policies managed via Terraform
• Azure Container Registry – Stores container images published from CI/CD
• Azure Key Vault – Holds secrets (Cezzis API subscription keys)
• Azure Monitor – Telemetry collection (logs/traces) via OpenTelemetry and OTLP exporter over HTTP/protobuf
• Shared Infrastructure Modules – Sourced from the reusable Terraform modules repo for consistency

📚 MCP Tools

The server exposes the following MCP tools:

search_cocktails

• Purpose: Search cocktails by natural language query
• Parameters:
  • freeText (string, required): Search terms (name, ingredients, style)
• Returns: Array of cocktails with IDs, titles, images, and summaries

get_cocktail

• Purpose: Retrieve full

... View full README on GitHub