Skip to main content
Glama

bazzite-mcp

MCP server plus local skill content for agents operating a Bazzite host.

Use it when the agent needs:

  • Bazzite-native knowledge and install choices

  • Live host state and guarded mutations

  • Desktop awareness: screenshots, windows, input, accessibility

  • Built-in Bazzite knowledge resources and official doc pointers

src/bazzite_mcp/ is the capability layer. skills/bazzite-operator/ is the workflow/policy layer.

Install

Requires Python 3.11+ and uv.

uv tool install bazzite-mcp
bazzite-mcp --version

From source:

git clone https://github.com/rolandmarg/bazzite-mcp.git
cd bazzite-mcp
uv sync

Related MCP server: coolify-mcp

MCP Setup

Claude Code:

{
  "mcpServers": {
    "bazzite": {
      "command": "bazzite-mcp"
    }
  }
}

Any stdio-capable MCP client can use the same command.

From a source checkout:

uv run --directory /path/to/bazzite-mcp python -m bazzite_mcp

Core MCP

The server exposes host capabilities for:

  • packages, ujust, updates, audit, rollback

  • system info, storage checks, snapshots, health checks

  • settings: theme, audio, power, display, gsettings

  • services, firewall, networking

  • containers and VMs

  • desktop control: screenshots, windows, AT-SPI actions, keyboard, mouse

  • gaming: Steam library, reports, MangoHud settings

  • lightweight docs/knowledge lookup and official source pointers

Resources:

  • bazzite://system/overview

  • bazzite://knowledge/index

  • bazzite://knowledge/install-policy

  • bazzite://knowledge/troubleshooting

  • bazzite://server/info

Skills

The repo includes skills/bazzite-operator/.

Use the skill for:

  • choosing the right Bazzite install path: ujust, Flatpak, Homebrew, Distrobox, VM, rpm-ostree

  • troubleshooting Bazzite-specific desktop, service, and update issues

  • turning raw MCP output into Bazzite-aware recommendations

Use MCP tools for live state and host changes. Use the skill for policy and workflow.

Utilities

Clean local data:

bazzite-mcp-cleanup

Remove config too:

bazzite-mcp-cleanup --include-config

License

MIT

Available Tools

24 tools
auditC

Query audit log or rollback a previous action.

Inputs: action (required), action_id, tool, search, +1 more. Returns: result

display_configB

Query or change display resolution, refresh rate, or scaling.

Inputs: action (required), output, resolution, refresh, +1 more. Returns: result

docsC

Search local Bazzite knowledge or return official changelog sources.

Inputs: action (required), query, version, count, +1 more. Returns: result

gamingC

Steam library, ProtonDB/PCGamingWiki reports, and per-game settings.

Inputs: action (required), app_id, name_filter, mangohud, +1 more. Returns: result

gsettingsC

Read or write a gsettings value.

Inputs: action (required), schema, key, value. Returns: result

interactC

Perform an action on a UI element via AT-SPI accessibility API.

Inputs: window (required), element (required), action. Returns: result

manage_distroboxC

Manage distrobox containers: create, list, enter, stop, remove, exec, or export apps.

Inputs: action (required), name, image, command, +1 more. Returns: result

manage_firewallC

Manage firewalld rules with audit logging and reload.

Inputs: action (required), port, service. Returns: result

manage_networkC

Manage NetworkManager connections and view network status.

Inputs: action (required), name, properties. Returns: result

manage_podmanC

Run podman container operations with dangerous flag blocking.

Inputs: action (required), container, image, command. Returns: result

manage_quadletB

Manage Quadlet units for persistent containerized services.

Inputs: action (required), name, image. Returns: result

manage_serviceB

Manage systemd services: start, stop, restart, enable, disable, status, or list.

Inputs: name, action, user, state. Returns: result

manage_snapshotsB

Manage btrfs home snapshots: list, status, or diff against current state.

Inputs: action (required), snapshot_id. Returns: result

manage_vmC

Manage VMs on Bazzite with hardened default profile support.

Inputs: action (required), name, iso_path, snapshot, +5 more. Returns: result

manage_windowsC

List, activate, or inspect windows via KWin/AT-SPI.

Inputs: action (required), window, depth. Returns: result

packagesC

Install, remove, search, list, or update packages across supported backends.

Inputs: action (required), package, method, source. Returns: result

quick_settingC

Switch theme, audio output, or power profile.

Inputs: setting (required), mode, device, profile. Returns: result

screenshotA

Capture a screenshot and return the image directly. This is a single-call tool — do NOT list windows or gather system info first.

Call with no arguments for a full desktop capture (all monitors). For a specific window: target='window', window='' — fuzzy-matches title or window class, activates the window, and captures it. No need to call manage_windows first. For the currently active window: target='window' with no window argument.

Inputs: target, window.

send_inputC

Send keyboard or mouse input via ydotool.

For mouse mode with coordinates from a screenshot, pass the metadata JSON string from the screenshot response as screenshot_meta.

Inputs: mode (required), keys, key, action, +5 more. Returns: result

set_textC

Set text content of an editable field via AT-SPI.

Inputs: window (required), element (required), text (required). Returns: result

storage_diagnosticsA

Capture full storage breakdown with optimization suggestions.

Inputs: no named parameters. Returns: result

system_doctorA

Run security and health checks with PASS, WARN, and FAIL assessments.

Inputs: no named parameters. Returns: result

system_infoA

Get system info: basic summary or full hardware report.

Inputs: detail. Returns: result

ujustC

Run, list, or inspect ujust commands.

Inputs: action (required), command, filter. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 24 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action, with clear boundaries even among similar functions like manage_windows, interact, and set_text, which focus on different aspects of UI management.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern or use the 'manage_' prefix, though a few like 'docs', 'gsettings', and 'packages' are noun-only, introducing minor inconsistency.

    Tool Count4/5

    With 24 tools, the set is slightly large but still scoped appropriately for a comprehensive system management server, avoiding unnecessary bulk.

    Completeness5/5

    The tools cover a broad range of system management tasks including networking, storage, security, containers, VMs, UI automation, and gaming, leaving few obvious gaps for the intended domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP server for managing Ubuntu servers with AI integration, enabling system monitoring, Docker control, Gitea repository management, Ollama LLM interaction, workspace file operations, and Claude Code assistant via natural language.
      34
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      MCP server that exposes Podman host management as tools, allowing natural language control of containers, images, volumes, networks, and pods. Includes an administrative console with safety profiles for gated access.
      18
      MIT