{
  "markdown": "# mcp-delonghi-ecam\n\nMCP server for DeLonghi ECAM espresso coffee machines via local network control.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-delonghi-ecam.svg)](https://pypi.org/project/mcp-delonghi-ecam/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-delonghi-ecam.svg)](https://pypi.org/project/mcp-delonghi-ecam/)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\nmcp-name: io.github.daedalus/mcp-delonghi-ecam\n\n## Overview\n\nThis 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.\n\n## Supported Machines\n\n- DeLonghi ECAM 550 series\n- DeLonghi Dinamica Plus\n- DeLonghi PrimaDonna Soul\n- Other ECAM-based machines with local LAN API\n\n## Install\n\n```bash\npip install mcp-delonghi-ecam\n```\n\n## Usage\n\n### As MCP Server\n\nRun the server:\n\n```bash\nmcp-delonghi-ecam\n```\n\nOr programmatically:\n\n```python\nfrom mcp_delonghi_ecam import mcp\n\nmcp.run()\n```\n\n### Tools Available\n\n| Tool | Description |\n|------|-------------|\n| `connect` | Connect to coffee machine at IP address |\n| `disconnect` | Disconnect from the machine |\n| `get_status` | Get current machine status |\n| `brew_beverage` | Brew a specific beverage |\n| `stop_brewing` | Stop current brewing |\n| `turn_on` | Turn machine on |\n| `turn_off` | Turn machine off |\n| `set_cup_light` | Control cup illumination |\n| `set_cup_warmer` | Control cup warmer |\n| `get_machine_info` | Get machine serial and model |\n| `get_statistics` | Get usage statistics |\n| `list_beverages` | List available beverages |\n| `get_recipe` | Get recipe for a beverage |\n\n### Example Usage\n\n```python\n# Connect to machine\nawait connect(\"192.168.1.100\")\n\n# Get status\nstatus = await get_status(\"markdown\")\n\n# Brew espresso\nresult = await brew_beverage(\"espresso\", 40, \"normal\", \"medium\")\n\n# Brew cappuccino\nresult = await brew_beverage(\"cappuccino\", 60, \"strong\", \"high\")\n\n# Turn on cup warmer\nawait set_cup_warmer(True)\n```\n\n## Configuration\n\nThe server connects to the coffee machine on the local network using:\n- **Default Port**: 10280\n- **Protocol**: HTTP (local LAN API)\n\nMake sure the coffee machine is connected to the same network as the MCP server.\n\n## Development\n\n```bash\ngit clone https://github.com/daedalus/mcp-delonghi-ecam.git\ncd mcp-delonghi-ecam\npip install -e \".[test]\"\n\n# Run tests\npytest\n\n# Format\nruff format src/ tests/\n\n# Lint\nruff check src/ tests/\n\n# Type check\nmypy src/\n```\n\n## API Reference\n\n### Beverage Types\n- `espresso`, `coffee`, `long_coffee`, `espresso_2x`\n- `doppio_plus`, `americano`, `cappuccino`\n- `latte_macchiato`, `caffe_latte`, `flat_white`\n- `espresso_macchiato`, `hot_milk`, `hot_water`, `steam`, `chocolate`\n\n### Taste Levels\n- `extra_mild`, `mild`, `normal`, `strong`, `extra_strong`\n\n### Temperature Settings\n- `low`, `medium`, `high`\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Credits\n\nProtocol information based on reverse-engineered specifications from:\n- longshot (Rust implementation)\n- ECAMpy\n- delonghi-coffee-link-python\n",
  "bytes": 3256,
  "sha": "0fbcc29c2b7229be0ab3900a88db46347cea9d45f168f8f82c92972ebce27b5b",
  "repo_slug": "daedalus/mcp-delonghi-ecam",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_daedalus_mcp_delonghi_ecam_97760ec8/readme"
}