convez.ai
MCP Server
zhdenny

bar-assistant-mcp-server

zhdenny/bar-assistant-mcp-server

Ver no GitHub
InicialPluginScore · de 0 a 100

Instalação

$npx convez-ai zhdenny/bar-assistant-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
3
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

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?"
Ver o original no GitHub

Relacionados