# 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

```bash
npm install -g k3b-mcp
```

## MCP configuration

Example `mcp.json` entry:

```json
{
  "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:

```json
{
  "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.