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.

This repository contains the Go-based MCP server for Cezzis.com cocktails. It exposes a streamable HTTP MCP interface that lets MCP clients search cocktail data, retrieve cocktail details, authenticate against Auth0, and submit user ratings through the Cezzis platform APIs.

Overview

The server is an integration layer, not the source of cocktail data. It registers MCP tools, forwards requests to the upstream Cocktails, AI Search, and Accounts APIs, stores authentication tokens in PostgreSQL per MCP session, and emits telemetry through OpenTelemetry.

Primary capabilities:

• Search cocktails by free text.
• Retrieve full cocktail details by cocktail ID.
• Start and manage Auth0 device-flow authentication.
• Submit authenticated cocktail ratings.
• Expose health and MCP HTTP endpoints for local and deployed environments.

Production Environment

Tech Stack

• Go 1.25.1
• Model Context Protocol over streamable HTTP via mark3labs/mcp-go
• OpenAPI-generated API clients for upstream Cezzis services
• Auth0 device authorization flow
• PostgreSQL for MCP session token storage
• OpenTelemetry and zerolog for observability
• Kubernetes manifests for local deployed environments under .iac/k8s
• Terraform for production Azure infrastructure under .iac/terraform

Repo Structure

.
├── .iac/
│   ├── argocd/      # Argo CD manifests for cluster sync
│   ├── k8s/         # Local Kubernetes deployment manifests
│   └── terraform/   # Production Azure infrastructure
├── .vscode/         # IDE launch configuration
├── cocktails.mcp/
│   ├── http-client.env.json
│   └── src/
│       ├── cmd/         # Application entry point
│       └── internal/
│           ├── api/     # Generated API clients
│           ├── auth/    # Auth0 flow and token handling
│           ├── db/      # PostgreSQL connection and setup
│           ├── mcpserver/
│           ├── middleware/
│           ├── repos/
│           ├── telemetry/
│           └── tools/   # MCP tool definitions and handlers
├── Dockerfile
├── makefile
└── mcp.http

HTTP Endpoints

... View full README on GitHub