Bar Assistant

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

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:

Variable	Required	Description
BAR_ASSISTANT_URL	Yes	Base URL of your Bar Assistant API (e.g., https://erikbarapi.duckdns.org)
BAR_ASSISTANT_TOKEN	Yes	API token from Bar Assistant
BAR_ASSISTANT_BAR_ID	No	Bar ID (default: 1)

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

Tool	Description
bar_search_cocktails	Search cocktails by name
bar_get_cocktail	Get detailed cocktail info
bar_list_cocktails	List cocktails with filters
bar_makeable_cocktails	Get cocktails you can make with shelf ingredients
bar_favorite_cocktails	Get favorite cocktails

Ingredients

Tool	Description
bar_search_ingredients	Search ingredients by name
bar_get_ingredient	Get detailed ingredient info
bar_list_ingredients	List ingredients with filters
bar_ingredient_cocktails	Get cocktails using an ingredient

Shelf & Shopping

Tool	Description
bar_get_shelf	Get shelf ingredients
bar_add_to_shelf	Add ingredients to shelf
bar_remove_from_shelf	Remove ingredients from shelf
bar_get_shopping_list	Get shopping list
bar_add_to_shopping_list	Add to shopping list

Collections & Reference

Tool	Description
bar_list_collections	List cocktail collections
bar_get_collection	Get collection details
bar_list_tags	List all tags
bar_list_glasses	List glass types
bar_list_methods	List preparation methods
bar_stats	Get bar statistics

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