v0.1.0 — Initial Release

bluefin-mcp v0.1.0

MCP server providing AI context for Project Bluefin systems. Part of the Bluefin Lightspeed initiative.

What This Is

bluefin-mcp is the semantic AI context layer for Bluefin. It complements linux-mcp-server — while linux-mcp-server provides system facts (journalctl, processes, logs), bluefin-mcp explains what Bluefin-specific things mean.

11 Tools (all read-only)

Tier	Tools
Atomic OS state	get_system_status, check_updates, get_boot_health, get_variant_info
Bluefin automation	list_recipes
Package management	get_flatpak_list, get_brew_packages, list_distrobox
Knowledge store	get_unit_docs, store_unit_docs, list_unit_docs

The knowledge store ships pre-populated with semantic documentation for all 10 Bluefin custom systemd units.

Install (once formula is in homebrew-tap)

brew install ublue-os/tap/bluefin-mcp

Manual install

git clone https://github.com/projectbluefin/bluefin-mcp
cd bluefin-mcp
just install

MCP Configuration

{
  "mcpServers": {
    "bluefin": {
      "command": "/home/linuxbrew/.linuxbrew/bin/bluefin-mcp"
    }
  }
}

⚠️ Use the absolute path — MCP clients may not inherit your shell PATH.