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