Bar Assistant MCP Server

A high-performance Model Context Protocol (MCP) server that provides intelligent cocktail search and recipe retrieval from Bar Assistant instances.

Features

• 🔍 Smart Cocktail Search - Natural language queries with similarity matching
• 📖 Complete Recipes - Detailed ingredients, instructions, and specifications
• 🎯 Similarity Engine - Discover cocktails similar to your favorites
• 🧪 Ingredient Analysis - Find cocktails by ingredients, flavors, and characteristics
• ⚡ Batch Processing - Retrieve multiple recipes simultaneously (5-10x faster)
• 💾 Smart Caching - Intelligent caching with 70%+ hit rate
• 🔧 Advanced Filtering - ABV ranges, glassware, preparation methods, and more

Prerequisites

• Docker and Docker Compose
• Access to a Bar Assistant instance
• Bar Assistant API token

Running with Docker

The only supported method for running the server is with Docker Compose.

1. Create an .env file:

   Create a file named .env in the root of the project and add the following, replacing the placeholder values with your actual Bar Assistant configuration:

   BAR_ASSISTANT_URL=https://your-instance.com
   BAR_ASSISTANT_TOKEN=your-api-token
   BAR_ASSISTANT_BAR_ID=1
   

2. Get Your Bar Assistant API Token:

   1. Log into your Bar Assistant instance
   2. Navigate to Settings → API
   3. Generate a new API token
   4. Copy the token and paste it into the BAR_ASSISTANT_TOKEN field in your .env file.

3. Build and start the container:

   docker-compose up --build -d
   

   The server will be available at http://localhost:3001.

Usage

Once configured, you can interact with the server through your MCP client. Here are some example queries:

• "What cocktails can I make with gin and vermouth?"
• "Show me the recipe for a Manhattan"
• "Give me recommendations on cocktails like a Negroni"
• "What ingredients do I need to buy to make these 5 cocktails?"
• "Show me how to make a Manhattan"
• "What cocktails can I make with gin and vermouth?"