Gaggiuino-mcp Server

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

Local serverstreamable-http

What is the Gaggiuino-mcp Server?

Gaggiuino-mcp is an MCP integration. Remote MCP server for your Gaggiuino espresso machine's shots and profiles.

Packages and local setup

The published oci package is ghcr.io/ljcl/gaggiuino-mcp:6.0.0. Its declared MCP transport is streamable-http.

The package declares 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: 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: 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.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 6.0.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
GAGGIUINO_URLGaggiuino machine URL (default http://gaggiuino.local)Optional
PORTServer port (default 8000)Optional
HOSTBind address (default 0.0.0.0)Optional
MCP_PUBLIC_URLPublic 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 exactlyOptional
MCP_OAUTH_SECRETSigning 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 inOptional
MCP_OAUTH_PASSPHRASE_HASHscrypt 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 itselfOptional
MCP_OAUTH_ISSUERExternal 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_HASHOptional
MCP_ALLOWED_ORIGINSComma-separated browser origins allowed to call /mcp, or to allow any (unsafe). Requests with no Origin header are unaffectedOptional
MCP_ALLOWED_HOSTSComma-separated Host header values to accept on /mcp. Empty disables host validationOptional
LOG_LEVELLog verbosity: debug, info, warn, error, or silent (default info). Logs are one JSON object per line on stderrOptional