Gaggiuino MCP Server
by ljclio.github.ljcl/gaggiuino-mcpv6.0.0
Remote MCP server for your Gaggiuino espresso machine's shots and profiles
context tax
queued
security
queued
cold start
queued
freshness
Active5d ago
Install Gaggiuino MCP server
No published package or hosted endpoint yet — see the repository README for build-from-source instructions.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| 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 | — | yes | 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 | — | yes | 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 |
Freshness
Active — last maintenance signal 5d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-05 · 5d ago · GitHub
Latest release
2026-10-05 · 5d ago · GitHub · v6.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-05 · 5d ago · official registry · v6.0.0
FAQ
›Does Gaggiuino require an API key?
Yes. It expects MCP_OAUTH_SECRET, MCP_OAUTH_PASSPHRASE_HASH, of which 2 are secrets.
›Can I use Gaggiuino as a remote (hosted) MCP server?
Yes. It is a hosted MCP server; connect to its URL with any client that supports remote MCP.
›Is Gaggiuino in the official MCP registry?
Yes, as io.github.ljcl/gaggiuino-mcp.