mcp-delonghi-ecam

mcp-delonghi-ecam

ローカルネットワーク経由でDeLonghi ECAMエスプレッソコーヒーマシンを操作するMCPサーバーです。

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

概要

このMCPサーバーは、ローカルネットワークAPIを通じてDeLonghi ECAMシリーズの全自動エスプレッソコーヒーマシンを包括的に操作できます。LLMがコーヒーマシンを操作して、飲み物の抽出、ステータスの監視、マシン設定の管理を行えるようにします。

対応マシン

• 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