io.github.ljcl/gaggiuino-mcp MCP Server

io.github.ljcl/gaggiuino-mcp

Repository Registry

What is the io.github.ljcl/gaggiuino-mcp MCP server?

Remote MCP server for your Gaggiuino espresso machine's shots and profiles

How to install io.github.ljcl/gaggiuino-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GAGGIUINO_URL
Gaggiuino machine URL (default http://gaggiuino.local)
PORT
Server port (default 8000)
HOST
Bind address (default 0.0.0.0)
MCP_PUBLIC_URL
Public https origin clients reach this server on, with no path (e.g. https://box.tailnet.ts.net). Set with MCP_OAUTH_SECRET to enable OAuth; it is advertised as the OAuth resource and must match the URL entered in the client exactly
MCP_OAUTH_SECRET
secret
Signing key for self-issued OAuth access and refresh tokens, at least 32 characters (openssl rand -hex 32). Keep it stable across restarts so clients stay signed in
MCP_OAUTH_PASSPHRASE_HASH
secret
scrypt hash of the passphrase you type on the OAuth consent page, in the form scrypt$N$r$p$salt$hash. Required whenever OAuth is enabled. Generate with `bun run hash-passphrase` — never store the passphrase itself
MCP_OAUTH_ISSUER
External OAuth issuer URL to delegate token issuing to (e.g. a Keycloak or Authentik realm). Puts the server in resource-server-only mode; requires MCP_PUBLIC_URL and refuses to start alongside MCP_OAUTH_SECRET or MCP_OAUTH_PASSPHRASE_HASH
MCP_ALLOWED_ORIGINS
Comma-separated browser origins allowed to call /mcp, or * to allow any (unsafe). Requests with no Origin header are unaffected
MCP_ALLOWED_HOSTS
Comma-separated Host header values to accept on /mcp. Empty disables host validation
LOG_LEVEL
Log verbosity: debug, info, warn, error, or silent (default info). Logs are one JSON object per line on stderr

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gaggiuino-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ljcl/gaggiuino-mcp:5.0.1"
      ],
      "env": {
        "GAGGIUINO_URL": "<YOUR_GAGGIUINO_URL>",
        "PORT": "<YOUR_PORT>",
        "HOST": "<YOUR_HOST>",
        "MCP_PUBLIC_URL": "<YOUR_MCP_PUBLIC_URL>",
        "MCP_OAUTH_SECRET": "<YOUR_MCP_OAUTH_SECRET>",
        "MCP_OAUTH_PASSPHRASE_HASH": "<YOUR_MCP_OAUTH_PASSPHRASE_HASH>",
        "MCP_OAUTH_ISSUER": "<YOUR_MCP_OAUTH_ISSUER>",
        "MCP_ALLOWED_ORIGINS": "<YOUR_MCP_ALLOWED_ORIGINS>",
        "MCP_ALLOWED_HOSTS": "<YOUR_MCP_ALLOWED_HOSTS>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}