Gaggiuino MCP
Remote MCP server for your Gaggiuino espresso machine's shots and profiles
- Pricing
- Open source
- Runs
- Remotely
- Version
- 6.0.0
- Listing updated
- 5 days ago
About Gaggiuino MCP
Gaggiuino MCP is an open-source MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add gaggiuino-mcp --env MCP_OAUTH_SECRET='<MCP_OAUTH_SECRET>' --env MCP_OAUTH_PASSPHRASE_HASH='<MCP_OAUTH_PASSPHRASE_HASH>' -- docker run -i --rm -e MCP_OAUTH_SECRET -e MCP_OAUTH_PASSPHRASE_HASH ghcr.io/ljcl/gaggiuino-mcp:6.0.0Add to claude_desktop_config.json
{
"mcpServers": {
"gaggiuino-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_OAUTH_SECRET",
"-e",
"MCP_OAUTH_PASSPHRASE_HASH",
"ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
],
"env": {
"MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
"MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gaggiuino-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_OAUTH_SECRET",
"-e",
"MCP_OAUTH_PASSPHRASE_HASH",
"ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
],
"env": {
"MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
"MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gaggiuino-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_OAUTH_SECRET",
"-e",
"MCP_OAUTH_PASSPHRASE_HASH",
"ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
],
"env": {
"MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
"MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gaggiuino-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_OAUTH_SECRET",
"-e",
"MCP_OAUTH_PASSPHRASE_HASH",
"ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
],
"env": {
"MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
"MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gaggiuino-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_OAUTH_SECRET",
"-e",
"MCP_OAUTH_PASSPHRASE_HASH",
"ghcr.io/ljcl/gaggiuino-mcp:6.0.0"
],
"env": {
"MCP_OAUTH_SECRET": "<MCP_OAUTH_SECRET>",
"MCP_OAUTH_PASSPHRASE_HASH": "<MCP_OAUTH_PASSPHRASE_HASH>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GAGGIUINO_URLGaggiuino machine URL (default http://gaggiuino.local)PORTServer port (default 8000)HOSTBind address (default 0.0.0.0)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 exactlyMCP_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 inMCP_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 itselfMCP_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_HASHMCP_ALLOWED_ORIGINSComma-separated browser origins allowed to call /mcp, or * to allow any (unsafe). Requests with no Origin header are unaffectedMCP_ALLOWED_HOSTSComma-separated Host header values to accept on /mcp. Empty disables host validationLOG_LEVELLog verbosity: debug, info, warn, error, or silent (default info). Logs are one JSON object per line on stderr
Pricing
Open source
Gaggiuino MCP FAQ
Is Gaggiuino MCP free?
Yes. Gaggiuino MCP is open source, so you can use and self-host it for free.
How do I add Gaggiuino MCP to Claude Code?
Run this command in your terminal: claude mcp add gaggiuino-mcp --env MCP_OAUTH_SECRET='<MCP_OAUTH_SECRET>' --env MCP_OAUTH_PASSPHRASE_HASH='<MCP_OAUTH_PASSPHRASE_HASH>' -- docker run -i --rm -e MCP_OAUTH_SECRET -e MCP_OAUTH_PASSPHRASE_HASH ghcr.io/ljcl/gaggiuino-mcp:6.0.0
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.