https://github.com/rolandmarg/bazzite-mcp
MCP server providing AI-native awareness and control of Bazzite OS
https://github.com/rolandmarg/bazzite-mcp
ai-agent bazzite mcp mcp-server
Last synced: 5 months ago
JSON representation
MCP server providing AI-native awareness and control of Bazzite OS
- Host: GitHub
- URL: https://github.com/rolandmarg/bazzite-mcp
- Owner: rolandmarg
- License: mit
- Created: 2026-03-03T22:22:53.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-03-04T02:27:54.000Z (5 months ago)
- Last Synced: 2026-03-04T03:42:30.388Z (5 months ago)
- Topics: ai-agent, bazzite, mcp, mcp-server
- Language: Python
- Size: 342 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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`.
```bash
uv tool install bazzite-mcp
bazzite-mcp --version
```
From source:
```bash
git clone https://github.com/rolandmarg/bazzite-mcp.git
cd bazzite-mcp
uv sync
```
## MCP Setup
Claude Code:
```json
{
"mcpServers": {
"bazzite": {
"command": "bazzite-mcp"
}
}
}
```
Any stdio-capable MCP client can use the same command.
From a source checkout:
```bash
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:
```bash
bazzite-mcp-cleanup
```
Remove config too:
```bash
bazzite-mcp-cleanup --include-config
```
## License
[MIT](LICENSE)