Skip to main content
Glama
daedalus

mcp-delonghi-ecam

by daedalus

mcp-delonghi-ecam

通过本地网络控制 DeLonghi ECAM 意式浓缩咖啡机的 MCP 服务器。

PyPI Python Ruff

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

概述

该 MCP 服务器通过咖啡机的本地网络 API,为 DeLonghi ECAM 系列自动意式浓缩咖啡机提供全面的控制能力。它让 LLM 能够与咖啡机交互,用于制作饮品、监控状态和管理机器设置。

Related MCP server: emsesp-mcp-server

支持的机器

  • DeLonghi ECAM 550 系列

  • DeLonghi Dinamica Plus

  • DeLonghi PrimaDonna Soul

  • 其他支持本地 LAN API 的 ECAM 机型

安装

pip install mcp-delonghi-ecam

使用

作为 MCP 服务器

运行服务器:

mcp-delonghi-ecam

或以编程方式运行:

from mcp_delonghi_ecam import mcp

mcp.run()

可用工具

工具

描述

connect

通过 IP 地址连接到咖啡机

disconnect

断开与咖啡机的连接

get_status

获取咖啡机当前状态

brew_beverage

冲煮指定饮品

stop_brewing

停止当前冲煮

turn_on

开启咖啡机

turn_off

关闭咖啡机

set_cup_light

控制杯灯照明

set_cup_warmer

控制杯盘加热器

get_machine_info

获取机器序列号和型号

get_statistics

获取使用统计信息

list_beverages

列出可用饮品

get_recipe

获取饮品的配方

示例用法

# 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)

配置

服务器通过以下配置连接局域网中的咖啡机:

  • 默认端口:10280

  • 协议:HTTP(本地 LAN API)

请确保咖啡机与 MCP 服务器连接到同一网络。

开发

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 参考

饮品类型

  • espresso, coffee, long_coffee, espresso_2x

  • doppio_plus, americano, cappuccino

  • latte_macchiato, caffe_latte, flat_white

  • espresso_macchiato, hot_milk, hot_water, steam, chocolate

口味等级

  • extra_mild, mild, normal, strong, extra_strong

温度设置

  • low, medium, high

许可证

MIT License - 详见 LICENSE 文件。

致谢

协议信息基于以下来源的逆向工程规范:

  • longshot (Rust 实现)

  • ECAMpy

  • delonghi-coffee-link-python

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables LLM applications to query and visualize data from Bosch/Buderus heat pumps via ems-ESP, including temperatures, statistics, and heat curves through natural language.
    9
    MIT
  • A
    license
    B
    quality
    B
    maintenance
    Enables AI clients to control Divoom LAN devices, including watchface management, brightness adjustment, and screen control through natural language.
    18
    65 npm
    5
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables LLMs to control Home Assistant devices, including lights, switches, and climate devices, through natural language commands.
    -