English Français العربية

io.github.daedalus/mcp-delonghi-ecam

Official registry Other

MCP server for DeLonghi ECAM espresso coffee machines via local network

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-delonghi-ecam
Claude Code 
claude mcp add mcp-delonghi-ecam -- uvx mcp-delonghi-ecam==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-delonghi-ecam": {
            "command": "uvx",
            "args": [
                "mcp-delonghi-ecam==0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-delonghi-ecam
  2. Overview
  3. Supported Machines
  4. Install
  5. Usage
  6. Configuration
  7. Development
  8. API Reference
  9. License
  10. Credits

mcp-delonghi-ecam

MCP server for DeLonghi ECAM espresso coffee machines via local network control.

mcp-name: io.github.daedalus/mcp-delonghi-ecam

Overview

This MCP server provides comprehensive control over DeLonghi ECAM series automatic espresso coffee machines through their local network API. It enables LLMs to interact with the coffee machine for brewing beverages, monitoring status, and managing machine settings.

Supported Machines

  • DeLonghi ECAM 550 series
  • DeLonghi Dinamica Plus
  • DeLonghi PrimaDonna Soul
  • Other ECAM-based machines with local LAN API

Install

pip install mcp-delonghi-ecam

Usage

As MCP Server

Run the server:

mcp-delonghi-ecam

Or programmatically:

from mcp_delonghi_ecam import mcp

mcp.run()
Tools Available
ToolDescription
connectConnect to coffee machine at IP address
disconnectDisconnect from the machine
get_statusGet current machine status
brew_beverageBrew a specific beverage
stop_brewingStop current brewing
turn_onTurn machine on
turn_offTurn machine off
set_cup_lightControl cup illumination
set_cup_warmerControl cup warmer
get_machine_infoGet machine serial and model
get_statisticsGet usage statistics
list_beveragesList available beverages
get_recipeGet recipe for a beverage
Example Usage
# Connect to machine
await connect("192.168.1.100")

# Get status
status = await get_status("markdown")

# Brew espresso
result = await brew_beverage("espresso", 40, "normal", "medium")

# Brew cappuccino
result = await brew_beverage("cappuccino", 60, "strong", "high")

# Turn on cup warmer
await set_cup_warmer(True)

Configuration

The server connects to the coffee machine on the local network using:

  • Default Port: 10280
  • Protocol: HTTP (local LAN API)

Make sure the coffee machine is connected to the same network as the MCP server.

Development

git clone https://github.com/daedalus/mcp-delonghi-ecam.git
cd mcp-delonghi-ecam
pip install -e ".[test]"

# Run tests
pytest

# Format
ruff format src/ tests/

# Lint
ruff check src/ tests/

# Type check
mypy src/

API Reference

Beverage Types
  • espresso, coffee, long_coffee, espresso_2x
  • doppio_plus, americano, cappuccino
  • latte_macchiato, caffe_latte, flat_white
  • espresso_macchiato, hot_milk, hot_water, steam, chocolate
Taste Levels
  • extra_mild, mild, normal, strong, extra_strong
Temperature Settings
  • low, medium, high

License

MIT License - see LICENSE file for details.

Credits

Protocol information based on reverse-engineered specifications from:

  • longshot (Rust implementation)
  • ECAMpy
  • delonghi-coffee-link-python

Frequently asked questions

What is io.github.daedalus/mcp-delonghi-ecam?

MCP server for DeLonghi ECAM espresso coffee machines via local network

How do I install io.github.daedalus/mcp-delonghi-ecam?

It runs on your machine. In Claude Code: claude mcp add mcp-delonghi-ecam -- uvx mcp-delonghi-ecam==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.daedalus/mcp-delonghi-ecam need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.daedalus/mcp-delonghi-ecam open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.daedalus/mcp-delonghi-ecam?

It is published by daedalus. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.