# AlbumentationsX MCP

An MCP server for dataset inspection, augmentation previews, run comparison, and reproducible pipeline export. Works with Claude Code and other listed MCP hosts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: dKosarevsky
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dKosarevsky/albu-mcp
- Updated: 2026-08-14
- HTML: https://affpapa.org/en/nevibecode/mcp/albumentationsx-mcp

## What it does

AlbumentationsX MCP gives an agent tools for discovering transforms, checking schemas, and reviewing image-processing results across classification, detection, segmentation, OCR, masks, bounding boxes, and keypoints. It can build contact sheets, show annotation overlays, compare preview runs, rank candidates, and export accepted pipelines as Python, JSON, or YAML.

The server includes CPU validation for `torch.Tensor` pipelines, structured feedback, tuning sessions, and a text-only review path when MCP Apps are unavailable. In Claude Code, the basic setup is `claude mcp add albu-mcp -- uvx albumentationsx-mcp`; environment variables can define the permitted image and artifact locations. Reads stay inside `--allowed-root`, while generated files remain under `--artifact-root`.

It cannot run free-form Python, retrieve images from the network, modify source datasets, or train models. The `review` capability profile uses a separate validation and rendering path; `run_first_preview` needs the `full` or `dataset` profile. That distinction matters when the first preview fails to start.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `ALBU_MCP_ALLOWED_ROOTS`, `ALBU_MCP_ARTIFACT_ROOT`, `ALBU_MCP_MAX_PREVIEW_RUNS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ALBU_MCP_ALLOWED_ROOTS=<ALBU_MCP_ALLOWED_ROOTS> --env ALBU_MCP_ARTIFACT_ROOT=<ALBU_MCP_ARTIFACT_ROOT> --env ALBU_MCP_MAX_PREVIEW_RUNS=<ALBU_MCP_MAX_PREVIEW_RUNS> --transport stdio albumentationsx-mcp -- uvx albumentationsx-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from albumentationsx-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add albumentationsx-mcp --env ALBU_MCP_ALLOWED_ROOTS=<ALBU_MCP_ALLOWED_ROOTS> --env ALBU_MCP_ARTIFACT_ROOT=<ALBU_MCP_ARTIFACT_ROOT> --env ALBU_MCP_MAX_PREVIEW_RUNS=<ALBU_MCP_MAX_PREVIEW_RUNS> -- uvx albumentationsx-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from albumentationsx-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "albumentationsx-mcp": {
            "command": "uvx",
            "args": [
                "albumentationsx-mcp"
            ],
            "env": {
                "ALBU_MCP_ALLOWED_ROOTS": "<ALBU_MCP_ALLOWED_ROOTS>",
                "ALBU_MCP_ARTIFACT_ROOT": "<ALBU_MCP_ARTIFACT_ROOT>",
                "ALBU_MCP_MAX_PREVIEW_RUNS": "<ALBU_MCP_MAX_PREVIEW_RUNS>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from albumentationsx-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "albumentationsx-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "albumentationsx-mcp"
            ],
            "env": {
                "ALBU_MCP_ALLOWED_ROOTS": "<ALBU_MCP_ALLOWED_ROOTS>",
                "ALBU_MCP_ARTIFACT_ROOT": "<ALBU_MCP_ARTIFACT_ROOT>",
                "ALBU_MCP_MAX_PREVIEW_RUNS": "<ALBU_MCP_MAX_PREVIEW_RUNS>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from albumentationsx-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ALBU_MCP_ALLOWED_ROOTS=<ALBU_MCP_ALLOWED_ROOTS> -e ALBU_MCP_ARTIFACT_ROOT=<ALBU_MCP_ARTIFACT_ROOT> -e ALBU_MCP_MAX_PREVIEW_RUNS=<ALBU_MCP_MAX_PREVIEW_RUNS> albumentationsx-mcp uvx albumentationsx-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from albumentationsx-mcp <command>

## When to use it
- inspect a dataset before tuning augmentations
- compare preview runs with contact sheets
- review masks and annotation overlays
- export an accepted pipeline as Python, JSON, or YAML
- validate a CPU `torch.Tensor` pipeline

## Example prompts
- Inspect `/absolute/path/to/images`, create a first preview at low intensity, and show the contact sheet.
- Compare the augmentation variants and reject the result marked `too_noisy:high`.
- Run the host smoke check, then call `trace_preview_variant` for the selected result before changing the pipeline.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md