Cocktail
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cocktail : "
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildRelated 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 for recipes by cocktail name |
| |
| Reverse lookup cocktails by ingredient |
| |
| Recommend a random cocktail | None | |
| Get detailed information about an ingredient |
| |
| Filter by category or alcohol content | `filter_type: "category" | "alcoholic" |
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 toolsfilter_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
Scored across 5 tools
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.
All tools follow a consistent verb_noun pattern (e.g., filter_cocktails, search_by_ingredient, get_random_cocktail), making it easy to predict functionality.
Five tools is an ideal scope for a cocktail recipe server, covering search, filter, ingredient lookup, and random discovery without unnecessary bloat.
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
Search 500 cocktail recipes, get full recipes, find drinks by ingredient, suggest random picks.
Cocktail recipes and an exact ingredient finder: what can I mix with what I have at home?
Cocktails from the bottles you own: recipes, bar terms, similar drinks, low and zero-proof picks.
Cocktails MCP — TheCocktailDB API (free, no auth)
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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-
- AlicenseAqualityDmaintenanceEnables intelligent cocktail discovery and recipe retrieval from Bar Assistant instances with natural language search, similarity matching, batch processing, and ingredient analysis capabilities.33MIT
- FlicenseAqualityDmaintenanceEnables management of your home bar inventory and cocktail discovery through Bar Assistant. View shelf ingredients, find cocktails you can make, and add or remove items from your bar collection.6-
- AlicenseCqualityDmaintenanceEnables searching for cocktail recipes by name or ingredients using the API Ninjas Cocktail API, supporting partial matches and ingredient-based filtering.1MIT