Bar Assistant MCP Server

MCP (Model Context Protocol) server for Bar Assistant, a cocktail recipe and bar management application.

Features

This MCP server provides tools for:

• Cocktails: Search, list, and get detailed cocktail information

• Ingredients: Search and browse ingredients

• Shelf Management: View and modify what's in your bar

• Shopping List: Manage your shopping list

• Collections: Browse cocktail collections

• Reference Data: List tags, glasses, and methods

Related MCP server: mcp-paprika

Installation

Using pip

pip install bar-assistant-mcp

From source

git clone https://github.com/yourusername/bar-assistant-mcp.git
cd bar-assistant-mcp
pip install -e .

Configuration

The server requires the following environment variables:

Getting an API Token

1. Log into your Bar Assistant instance

2. Go to Profile → Personal Access Tokens

3. Create a new token with appropriate permissions

4. Copy the token (it's only shown once)

Configuration

Claude Code (Linux/WSL)

Create or edit .mcp.json in your home directory or project directory:

{
  "mcpServers": {
    "bar-assistant": {
      "command": "/path/to/bar-assistant-mcp/.venv/bin/python",
      "args": ["-m", "bar_assistant_mcp.server"],
      "env": {
        "BAR_ASSISTANT_URL": "https://your-bar-assistant-url.com",
        "BAR_ASSISTANT_TOKEN": "your-api-token"
      }
    }
  }
}

Then restart Claude Code. The MCP server will be available when working in that directory.

Claude Desktop (Windows)

Edit %APPDATA%\Claude\claude_desktop_config.json (typically C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "bar-assistant": {
      "command": "python",
      "args": ["-m", "bar_assistant_mcp.server"],
      "env": {
        "BAR_ASSISTANT_URL": "https://your-bar-assistant-url.com",
        "BAR_ASSISTANT_TOKEN": "your-api-token"
      }
    }
  }
}

Note for Windows: You'll need to install the package first:

pip install bar-assistant-mcp

Or if running from source, use the full path to python in the venv.

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bar-assistant": {
      "command": "/path/to/bar-assistant-mcp/.venv/bin/python",
      "args": ["-m", "bar_assistant_mcp.server"],
      "env": {
        "BAR_ASSISTANT_URL": "https://your-bar-assistant-url.com",
        "BAR_ASSISTANT_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Cocktails

Ingredients

Shelf & Shopping

Collections & Reference

Development

Setup

git clone https://github.com/yourusername/bar-assistant-mcp.git
cd bar-assistant-mcp
pip install -e ".[dev]"

Testing

# Run the test script
cd mcpb
python test_mcp.py --list

# Call a specific tool
python test_mcp.py --call bar_search_cocktails '{"query": "margarita"}'

Building MCPB Package

cd mcpb
python build_mcpb.py

License

MIT