Random Cocktail Finder MCP Server

Fetches a random cocktail recipe, including its name, ingredients, instructions, and an image for mixology inspiration. Designed for integration with Claude Desktop using the Model Context Protocol (MCP).

Installation

You can use via npm or npx:

• npm install (recommended for local use): npm install @dennisk2025/random-cocktail-finder

• npx (zero-install): npx @dennisk2025/random-cocktail-finder

Adding to Claude Desktop

To add this MCP server to Claude Desktop, insert the following into your claude_desktop_config.json:

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

Add this to your Claude Desktop config file at:

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

Usage

Once the server is running, it provides one tool:

Tool: get_random_cocktail

• Description: Returns the name, ingredients, instructions, and image for a randomly selected cocktail.
• Parameters: none (expects an empty object)

Example Tool Call

Request:

{
  "tool": "get_random_cocktail",
  "parameters": {}
}

Response:

{
  "name": "Margarita",
  "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Take care to moisten only the outer rim and pour out the excess salt. Shake the other ingredients with ice, then carefully pour into the 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 }
  ],
  "image": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg"
}

Available Tools

| Tool Name | Description | Parameters | |----------------------|---------------------------------------------------------------------------------------|----------------------------| | get_random_cocktail | Returns the name, ingredients, instructions, and image for a randomly selected cocktail.| (none) |

All results are returned as structured JSON for direct consumption by chatbots, clients, or mixologist apps.

If you encounter problems or have feature requests, open an issue on the package repository or contact the maintainer.