Gaggiuino MCP Server

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
   

設定

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

• GAGGIUINO_BASE_URL：Gaggiuino API の URL（デフォルト：http://localhost:3000）
• SERVER_PORT：HTTP トランスポート用のポート（デフォルト：8080）
• MCP_TRANSPORT_TYPE：トランスポートの種類（stdio または http、デフォルト：stdio）
• REQUEST_TIMEOUT：API リクエストのタイムアウト（ミリ秒）（デフォルト：5000）
• LOG_LEVEL：ログレベル（デフォルト：info）

使用方法

サーバーの起動

npm start

ホットリロードを使用した開発の場合：

npm run dev

MCP Inspector でのテスト

npm run inspect

Claude Desktop への接続

1. Claude Desktop で、Settings > MCP Servers に移動します
2. 次のコマンドを指定して、新しいサーバーを追加します：node /path/to/mcp-server-gaggiuino/dist/index.js

API リファレンス

ツール

• getSystemStatus：エスプレッソマシンの現在の状態を取得
• getLatestShot：最新のショットの ID を取得
• getShotData：ID を指定して、特定のショットの詳細データを取得
• getAllProfiles：利用可能なすべてのプロファイルの一覧を取得
• selectProfile：ID を指定してプロファイルを選択
• deleteProfile：ID を指定してプロファイルを削除
• uploadShot：新しいショットのデータをアップロード

ライセンス

MIT

謝辞

• Gaggiuino Project
• FastMCP
• Model Context Protocol