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

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