K3B-MCP

MCP server for burning optical media using the K3b CLI (k3bcli).

Requirements

• Linux host with K3b installed (k3bcli available on PATH)
• Node.js v22+ (current host runtime detected)

If k3bcli is not on PATH, set K3BCLI_PATH to the full binary path.

Install

npm install -g k3b-mcp

MCP configuration

Example mcp.json entry:

{
  "mcpServers": {
    "k3b": {
      "command": "k3b-mcp",
      "env": {
        "K3BCLI_PATH": "k3bcli"
      }
    }
  }
}

Tools

• k3bcli_help: show k3bcli --help output.
• list_optical_drives: list available optical drives (uses k3bcli --list-devices).
• create_data_disc_from_folder: burn a data disc from a folder (supports optional label and copies).
• run_k3bcli: run any k3bcli command directly.

Example usage

1. Discover flags if needed
   • Call k3bcli_help.
2. List drives
   • Call list_optical_drives.
3. Burn a folder to disc
   • Call create_data_disc_from_folder with the folder path and optional device/speed/label/copies.

Example tool call payload:

{
  "folder": "/home/user/projects/burn-this",
  "device": "/dev/sr0",
  "speed": 8,
  "label": "MY_ARCHIVE_2026",
  "copies": 3
}

Note: The create_data_disc_from_folder tool uses k3bcli --data and --copies for multiple burns. If your K3b version uses different flags, use run_k3bcli with the correct arguments.