gaggiuino-mcp

Name: gaggiuino-mcp
Author: AndrewKlement

@AndrewKlement

リポジトリ

gaggiuino-mcp について

Gaggiuino MCP server

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

AndrewKlement

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "gaggiuino": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/gaggiuino-mcp",
        "run",
        "gaggiuino.py"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is gaggiuino-mcp?

gaggiuino-mcp is a lightweight Model Context Protocol (MCP) server built for Gaggiuino, the open-source espresso machine controller for the Gaggia Classic. It is designed to integrate easily with AI clients that want to display or analyze data from the Gaggiuino system in real time.

How to use gaggiuino-mcp?

Configure the server in your MCP client (e.g., Claude Desktop) using the uv command pointing to the gaggiuino.py script in the cloned repository. Alternatively, install it automatically via Smithery with npx -y @smithery/cli install @AndrewKlement/gaggiuino-mcp --client claude. The server exposes three tools: getStatus, getLatestShotId, and getShotData.

Key features of gaggiuino-mcp

Real-time access to shot telemetry
Retrieve current espresso machine status
Access the latest espresso shot ID
Fetch detailed shot data for a given ID
Designed for local network access
Lightweight and easy to set up

Use cases of gaggiuino-mcp

Analyzing latest espresso shot data with an AI assistant
Monitoring machine status (temperature, pressure) in real time
Automating shot logging and performance evaluation
Integrating espresso machine data into custom dashboards or workflows

FAQ from gaggiuino-mcp

What does gaggiuino-mcp do?

It reads real-time data from a Gaggiuino-controlled espresso machine — including current status, latest shot ID, and full shot data — and makes it available to AI clients via the Model Context Protocol.

What are the runtime dependencies?

The server runs as a Python script using uv. You need Python and uv installed, and the repository cloned locally.

Where does the data come from and where is it stored?

Data is fetched live from the Gaggiuino system on the local network. No external cloud storage is used; all data remains within the local network.

Are there any known limits or constraints?

The README does not mention specific limits. The server is designed for local network access only, and reliable operation depends on network connectivity to the Gaggiuino controller.

What transport and authentication does it use?

It uses standard MCP stdio transport (launched as a subprocess). No authentication is described; access is restricted by network boundaries (local network).