mcpField
M
mcp-delonghi-ecam

mcp-delonghi-ecam

本地服务
github.com/daedalus其他127 周前更新
代码仓库

关于 mcp-delonghi-ecam

mcp-delonghi-ecam 是通过本地网络控制 DeLonghi ECAM 系列全自动咖啡机的 MCP 服务。它向基于 LLM 的客户端提供冲泡、状态查询和机器设置功能。

主要功能

  1. 01连接或断开咖啡机
  2. 02查询机器状态和信息
  3. 03冲泡饮品或停止冲泡
  4. 04控制电源、杯灯和杯架加热
  5. 05列出饮品并获取配方
  6. 06查看使用统计

适用场景

  1. 01通过 MCP 客户端冲泡饮品
  2. 02查询本地网络中咖啡机的状态
  3. 03管理机器电源和杯具设置

MCP 相关

它向 MCP 客户端提供连接 DeLonghi ECAM 咖啡机以及控制冲泡、状态和设置的工具。与咖啡机的通信使用其本地网络 API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "daedalus-mcp-delonghi-ecam": {
      "command": "uvx",
      "args": [
        "mcp-delonghi-ecam"
      ]
    }
  }
}
启动命令uvx mcp-delonghi-ecam

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-delonghi-ecam0.1.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-delonghi-ecam

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

PyPI Python Ruff

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

概述

此 MCP 服务通过本地网络 API，全面控制 DeLonghi ECAM 系列全自动意式浓缩咖啡机。它支持大模型与咖啡机交互，冲泡饮品、监控状态并管理机器设置。

支持的机器

  • 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 文件。

鸣谢

协议信息基于以下项目逆向工程得出的规范：

  • longshot（Rust 实现）
  • ECAMpy
  • delonghi-coffee-link-python

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。