MCP Server Gaggiuino

🚀 Gaggiuino MCP サーバー

Gaggiuinoで改造されたエスプレッソマシンに対して、標準化されたインターフェースを提供するModel Context Protocol (MCP) サーバーです。このサーバーはMCPプロトコルを通じて、GaggiaエスプレッソマシンのAPIにアクセスし、制御することができます。

✨ 主な機能

• ミルクフォームデータとその履歴へのアクセス
• エスプレッソレシピの閲覧と管理
• 機械の状態をリアルタイムで監視
• 新しいミルクフォームデータのアップロード
• AIアシスタントや他のMCPクライアントとの互換性

📦 インストール

前提条件

• Node.js 18以上
• HTTPでアクセス可能なGaggiuino改造エスプレッソマシン
• npmまたはyarn

インストール手順

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/mcp-server-gaggiuino.git
   cd mcp-server-gaggiuino
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

🔧 設定

環境変数を使用してサーバーを設定します：

💻 使用例

サーバーの起動

npm start

開発用でホットリロード付き：

npm run dev

MCP インスペクターとの併用

npm run inspect

Claude Desktop への接続

1. Claude Desktop で、設定 > MCP サーバーに移動します。
2. 新しいサーバーを追加し、コマンドを node /path/to/mcp-server-gaggiuino/dist/index.js とします。

📚 ドキュメント

API リファレンス

ツール

• getSystemStatus：現在のコーヒーマシンの状態を取得
• getLatestShot：最新のミルクフォームIDを取得
• getShotData：IDに基づいて特定のミルクフォームの詳細データを取得
• getAllProfiles：利用可能なすべてのレシピのリストを取得
• selectProfile：IDでレシピを選択
• deleteProfile：IDでレシピを削除
• uploadShot：新しいミルクフォームデータをアップロード

📄 ライセンス

MIT

謝辞

• Gaggiuino プロジェクト
• FastMCP
• Model Context Protocol