random-cocktail-recipe

Fetches a random cocktail recipe including ingredients, instructions, and an image, helping users discover new drinks.

Installation

You can use this MCP server locally or via npx. It will auto-install dependencies:

npx @dennisk2025/random-cocktail-recipe

Or install globally:

npm install -g @dennisk2025/random-cocktail-recipe

Or as a project dependency:

npm install @dennisk2025/random-cocktail-recipe

Adding to Claude Desktop

Add the following to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Example claude_desktop_config.json Section

{
  "mcpServers": {
    "random-cocktail-recipe": {
      "command": "npx",
      "args": ["@dennisk2025/random-cocktail-recipe"]
    }
  }
}

Usage

When added to Claude or running as a local MCP server, you get the following tool:

Available Tools

• get_random_cocktail
  • Description: Returns a random cocktail recipe with name, ingredients, instructions, and image.
  • Parameters: None

Example Tool Call

Tool: get_random_cocktail

Input:

{}

Response (example):

{
  "name": "Margarita",
  "category": "Ordinary Drink",
  "alcoholic": "Alcoholic",
  "glass": "Cocktail glass",
  "ingredients": [
    { "ingredient": "Tequila", "measure": "1 1/2 oz" },
    { "ingredient": "Triple sec", "measure": "1/2 oz" },
    { "ingredient": "Lime juice", "measure": "1 oz" },
    { "ingredient": "Salt", "measure": null }
  ],
  "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Take care to moisten.. (etc)",
  "image": "https://www.thecocktaildb.com/images/media/drink/wpxpvu1439905379.jpg"
}

Error Handling

If the cocktail API is unavailable or returns an error, the tool will return a clear error message and log details to stderr for diagnosis.

Discover new drinks every time you run the tool. Enjoy responsibly!