☕ Doppio Coffee MCP Server

Order freshly roasted specialty coffee from DOPPIO roastery (Zilina, Slovakia) directly through AI assistants.

---

Features

• Browse Coffee Catalog - Filter by origin, roast level, flavor notes, acidity, bitterness
• Personalized Suggestions - AI recommends coffees based on your saved preferences
• One-Click Ordering - Create checkout with automatic 20% MCP discount
• Save Preferences - Remember your brewing method, favorite size, and shipping address
• Slovak Roastery - Fresh coffee from Zilina, shipped across Europe

---

Quick Start

Option 1: Download Bundle (Easiest)

1. Download doppio-coffee-mcp.mjs from Releases
2. Add to Claude Desktop config:

{
  "mcpServers": {
    "doppio-coffee": {
      "command": "node",
      "args": ["/path/to/doppio-coffee-mcp.mjs"]
    }
  }
}

3. Restart Claude Desktop and start ordering coffee!

Option 2: npx (Recommended)

{
  "mcpServers": {
    "doppio-coffee": {
      "command": "npx",
      "args": ["-y", "doppio-coffee-mcp"]
    }
  }
}

Note: The -y flag auto-confirms the package installation.

Option 3: Build from Source

git clone https://github.com/tomas-chudjak/doppio-coffee-mcp.git
cd doppio-coffee-mcp/mcp-server
npm install
npm run build

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

---

Available Tools

list_coffees

Browse available coffees with powerful filtering.

Parameter	Type	Description
preparation	filter | espresso | omni	Brewing method
coffee_type	robusta | arabica | blend | decaf	Coffee type
size	small | medium | large	Package size
origin	string	Country (e.g., "Brazil", "Ethiopia")
roast_level	string	Roast level (Light, Medium, Dark)
price_max	number	Maximum price in EUR
flavor	string	Flavor note (chocolate, fruit, nuts...)
altitude_min	number	Minimum altitude in meters
acidity_min / acidity_max	1-5	Acidity level (higher = brighter)
bitterness_min / bitterness_max	1-5	Bitterness level (higher = more intense)

Example: "Show me Ethiopian coffees with fruity notes under 15 EUR"

---

get_coffee_detail

Get detailed information about a specific coffee including origin story, processing method, and tasting notes.

Parameter	Type	Description
coffee_id	string	Coffee ID from catalog

---

create_order

Create an order with automatic 20% MCP discount.

Parameter	Type	Description
items	array	List of coffees to order
items[].coffee_id	string	Coffee ID
items[].size	small | medium | large	Package size
items[].quantity	number	Number of bags
email	string	Email for order (optional if saved)

Example: "Order 2 bags of large Dolce Vita"

---

set_preferences

Save your coffee preferences for faster ordering.

Parameter	Type	Description
preparation	filter | espresso | omni	Your brewing method
coffee_type	string	Preferred coffee type
default_size	small | medium | large	Default package size
email	string	Email for orders
shipping_address	object	Your shipping address

---

get_preferences

Retrieve your saved preferences.

---

Package Sizes

Size	Weight	Best For
small	220g	Trying new coffees
	330g	Filter only coffees
medium	500g	Regular consumption
large	1kg	Daily drinkers, offices

---

Example Conversations

Browsing:

"What coffees do you have from Ethiopia?" "Show me something with chocolate notes, low acidity" "I want a light roast for filter brewing"

Ordering:

"Order a large bag of Dolce Vita" "I'll take 2x medium Rwanda and 1x large Brazil" "Reorder my usual coffee"

Preferences:

"I use an espresso machine, remember that" "My default size should be large" "Save my email as john@example.com"

---

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode (auto-rebuild)
npm run dev

# Run server
npm start

Project Structure

mcp-server/
├── src/
│   ├── index.ts      # MCP server & tool definitions
│   ├── api.ts        # Backend API client
│   ├── preferences.ts # Local preferences storage
│   └── types.ts      # TypeScript interfaces
├── dist/             # Compiled JavaScript
└── package.json

---

Support

For questions or issues:

• Website: www.kavadoppio.sk
• Issues: GitHub Issues

---

License

MIT License - see LICENSE for details.

---