gaggiuino-mcp

gaggiuino-mcp

Gaggiuino MCP サーバー これは、オープンソースの Gaggia Classic 用エスプレッソマシンコントローラーであるGaggiuino向けに構築された、軽量な Model Context Protocol（MCP）サーバーです。Gaggiuino システムのデータをリアルタイムで表示または分析したい AI クライアントと、簡単に連携できるよう設計されています。

このプロジェクトについて執筆した記事はこちらです https://medium.com/@a.klement.w/dialing-in-espresso-using-mcp-server-0207819fe93a

接続されたクライアントでできること：

• 現在のマシンのステータスを取得する

• 最新のショット ID にアクセスする

• 指定した ID のショットデータを取得する

特徴

📊 ショットのテレメトリーにリアルタイムでアクセス

🌐 ローカルネットワークからのアクセスを想定した設計

使用方法

Claude Desktop を使用する場合

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

Smithery 経由でインストールする

Smithery 経由で Claude Desktop 用の Gaggiuino Espresso Machine Server を自動的にインストールするには：

npx -y @smithery/cli install @AndrewKlement/gaggiuino-mcp --client claude

利用可能なツールセット

ツールセット	説明
getLatestShotId	最新のエスプレッソショット ID を取得する
getShotData	指定した ID のエスプレッソショットデータを取得する。引数：id：ショット ID
getStatus	エスプレッソマシンのステータスを取得する

例

ユーザー：

最新のエスプレッソショットデータを分析してください

Claude：

最新のエスプレッソショットのデータを取得して分析します。まずエスプレッソマシンの状態を確認してから、最新のショット情報を取得します。 getStatus 次に、最新のエスプレッソショットのIDを取得します。 getLatestShotId ショット #188 のデータを取得します。 getShotData 取得したデータに基づき、最新のエスプレッソショット（ID #188）を分析します。分析結果は以下のとおりです。

マシンの状態とショットの概要 マシンは現在、57.2°C、圧力 -0.1 bar でアイドル状態です。分析対象のショットは、タイムスタンプに基づくと2025年4月19日に抽出され、所要時間は合計で 26.5秒でした（0.1秒間隔のデータポイントが265件）。

プロファイル情報 「Leva 9 LR v0.5」プロファイルを使用しています。これは、出力40gを目標に圧力を段階的に下げる複数フェーズのプロファイルです。プロファイルは次のとおりです。

1. 7 ml/s での流量制御プレインフュージョン
2. 流量を3.5 ml/sに段階的に下げる
3. 3 bar の圧力制限をかけた、流量1.5 ml/sでのプレエクストラクション
4. 2秒かけて圧力を9 barまで上げる
5. 圧力を段階的に下げる一連のステップ（8.8→6.0 bar）

ショット分析 プレインフュージョンおよび抽出フェーズ

• プレインフュージョン（0～5秒）：高い流量（6～7 ml/s）で開始し、圧力を低く（0.3～0.6 bar）保つことで、コーヒーパックを飽和させています。
• 最初の加圧（5～10秒）：流量が約1.5 ml/sまで下がる一方、圧力は徐々に約2.5 barまで上昇しました。
• 圧力プロファイルフェーズ（10～15秒）：圧力は約3 barに保たれ、流量は約0.8 ml/sまで下がりました。
• 圧力上昇（15～20秒）：プログラムされたプロファイルに従い、約5秒かけて圧力が3 barから8.9 barまで上昇しました。
• 圧力低下フェーズ（20～26.5秒）：プロファイルのステップに従い、圧力は約8.5 barから6.4 barまで徐々に下がりました。

主な測定値

• 最終抽出量：38g（最終ショット重量に基づく）
• ブリューレシオ：コーヒーの粉量が提示されていないため算出できません
• 温度安定性：非常に良好。抽出中は92.8～94.1°Cを維持
• 最初の滴下：約11～12秒（プレインフュージョンの約75％経過時）に開始
• 最大流量：7.2 ml/s（開始時）
• 最大圧力：8.9 bar（約20秒時点）

抽出の動き

1. 流量：プログラムどおり、プレインフュージョン中に高い流量（7 ml/s）から3.5 ml/s、さらに1.5 ml/sへと段階的に下がり、その後、抽出中は約2.8 ml/sで安定しました。
2. 給水量：ポンプで送られた水の総量は87.7 mlで、カップに入った量は38gでした。このことから、コーヒーパックにかなりの量の水が保持されたことがうかがえます。
3. 圧力プロファイル：プレインフュージョンから抽出にかけて圧力が非常に良好に推移しており、圧力が下がるフェーズへの移行も滑らかです。

パフォーマンス評価 プログラムされたプロファイルによく従った、技術的に優れたショットのようです。

• 温度制御：93～94°C付近で非常に安定
• 圧力曲線：滑らかに移行しながらプログラムされたプロファイルに沿って推移
• 抽出流量：主な抽出フェーズ中は一定
• 抽出量：38gを達成（目標の40gに近い）

このショットについて、特定の点に関するより具体的なおすすめをご希望ですか？それとも、詳しく分析してほしいパラメーターはありますか？