Skip to main content
Glama
Cocktail

Cocktail

Cocktail MCP Server

An MCP server that uses TheCocktailDB API. By connecting it to Claude Desktop, you can search for cocktail recipes and retrieve ingredient information using natural language.

Setup

npm install
npm run build

Related MCP server: Bar Assistant MCP Server

Claude Desktop Configuration

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "cocktail": {
      "command": "node",
      "args": ["/path/to/cocktail-mcp-server/dist/index.js"]
    }
  }
}

Available Tools

Tool Name

Description

Arguments

search_cocktail

Search for recipes by cocktail name

name: string

search_by_ingredient

Reverse lookup cocktails by ingredient

ingredient: string

get_random_cocktail

Recommend a random cocktail

None

get_ingredient_info

Get detailed information about an ingredient

ingredient: string

filter_cocktails

Filter by category or alcohol content

`filter_type: "category"

"alcoholic", value: string`

Example Conversations

ユーザー: モヒートの作り方教えて
Claude: モヒートのレシピですね!
  【材料】ライトラム 2-3 oz、ライムジュース 1 oz、砂糖 2 tsp、ミント...

ユーザー: ウォッカで作れるカクテル何がある?
Claude: ウォッカを使ったカクテルはこちらです!
  1. Moscow Mule  2. Vodka Martini  3. Cosmopolitan...

ユーザー: 今日のおすすめカクテル出して
Claude: こんなのはいかがですか? Old Fashioned...

Development

npm test            # テスト実行
npm run test:watch  # ウォッチモード

Tech Stack

  • TypeScript / Node.js

  • @modelcontextprotocol/sdk (MCP SDK)

  • Zod (Validation)

  • Vitest (Testing)

  • TheCocktailDB API (Test API key "1")

Available Tools

5 tools
filter_cocktailsB

Filter cocktails by category (e.g., 'Ordinary Drink', 'Cocktail') or by alcoholic/non-alcoholic.

Inputs: filter_type (required), value (required).

get_ingredient_infoA

Get detailed information about a cocktail ingredient, including description, type, and whether it contains alcohol.

Inputs: ingredient (required).

get_random_cocktailA

Get a random cocktail suggestion with full recipe details. Great for discovering new drinks.

Inputs: no named parameters.

search_by_ingredientC

Find cocktails that can be made with a specific ingredient. Returns a list of cocktail names and thumbnails.

Inputs: ingredient (required).

search_cocktailA

Search for cocktail recipes by name. Returns ingredients, measurements, instructions, and image URL.

Inputs: name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct operation: searching by name, filtering by category, searching by ingredient, getting ingredient info, and random discovery. No overlaps in purpose.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (e.g., filter_cocktails, search_by_ingredient, get_random_cocktail), making it easy to predict functionality.

    Tool Count5/5

    Five tools is an ideal scope for a cocktail recipe server, covering search, filter, ingredient lookup, and random discovery without unnecessary bloat.

    Completeness4/5

    The set covers search, filtering, ingredient details, and random discovery. Missing features like rating or user-added recipes are not essential for a reference server.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables recipe search, storage, and meal planning using TheMealDB API. Provides comprehensive recipe discovery, automatic recipe collection management, and custom meal plan creation with detailed cooking instructions and ingredients.
      2
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables intelligent cocktail discovery and recipe retrieval from Bar Assistant instances with natural language search, similarity matching, batch processing, and ingredient analysis capabilities.
      3
      3
      MIT