mcpField
M
mcp-delonghi-ecam

mcp-delonghi-ecam

Local
github.com/daedalusOther1Updated 27w ago
Repository

About mcp-delonghi-ecam

mcp-delonghi-ecam is an MCP server for controlling DeLonghi ECAM-series automatic espresso machines over a local network. It exposes brewing, status checks, and machine settings for LLM-based clients.

Key features

  1. 01Connect to and disconnect from a machine
  2. 02Check machine status and information
  3. 03Brew or stop beverages
  4. 04Control power, cup light, and cup warmer
  5. 05List beverages and retrieve recipes
  6. 06View usage statistics

Use cases

  1. 01Brew a beverage through an MCP client
  2. 02Check machine status on the local network
  3. 03Manage machine power and cup settings

MCP support

Exposes tools for connecting to DeLonghi ECAM machines and controlling brewing, status, and settings to MCP clients. Communication with the machine uses its local network API.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "daedalus-mcp-delonghi-ecam": {
      "command": "uvx",
      "args": [
        "mcp-delonghi-ecam"
      ]
    }
  }
}
Run commanduvx mcp-delonghi-ecam

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-delonghi-ecam0.1.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-delonghi-ecam

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

PyPI Python Ruff

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.