AlbumentationsX MCP
Install
uvx --from albumentationsx-mcp albumentationsx-mcp
uvx --from albumentationsx-mcp albumentationsx-mcp \
--allowed-root /absolute/path/to/images \
--artifact-root /absolute/path/to/albu-artifacts
First Run Prompt
Use this as the first host task:
Use AlbumentationsX MCP on image or directory `DATASET_PATH`. Read from `ALLOWED_ROOT` and write to `ARTIFACT_ROOT`. When the host exposes resource reads, read `albumentationsx://examples/client-smoke`; if resource reads are unavailable, call `get_workflow_example` with `example_id="client-smoke"`. Then call `run_host_smoke_check`. Continue only when `preview_ready` is true. If `preview_ready` is false, call `diagnose_environment` and stop before rendering. Then call `plan_dataset_onboarding`, `build_review_packet`, `validate_preview_request`, and `render_preview_batch`. Render at most 6 images on the first pass. Show the contact sheet path and ask for concrete feedback before `adjust_pipeline` or `export_pipeline`.
Host Config Hints
- Codex plugin mode uses
.codex-plugin/plugin.json and .mcp.json; its pinned server grants no user dataset root.
- Set
ALBU_MCP_ALLOWED_ROOTS and ALBU_MCP_ARTIFACT_ROOT, or use explicit absolute host args. Never rely on the working directory.
- Restart, run
run_host_smoke_check, and stop unless allowed_roots contains the intended root and preview_ready is true.
Host Workflow
- Read
albumentationsx://examples/client-smoke; if resource reads are unavailable, call get_workflow_example with example_id="client-smoke".
- Call
run_host_smoke_check next; continue only when preview_ready is true.
- Call
plan_dataset_onboarding, then build_review_packet for one image or folder.
- Validate user paths with
validate_preview_request before rendering.
- Render a small sample with
render_preview_batch; inspect the contact sheet.
- Record feedback with
record_preview_feedback, such as too_noisy:high or exposure_too_weak.
adjust_pipeline, re-render, and compare before acceptance.
- Export only reviewed work with
export_pipeline or requested report tools.
Safety Rules
- Do not train, overwrite datasets, or fetch remote images.
- Keep private paths, filenames, and image contents out of public reports.
- Generated fixtures, contact sheets, and rehearsals are not beta evidence.
- Read only under
--allowed-root; write only under --artifact-root.
- Re-run validation after changing paths, masks, bboxes, labels, or annotation formats.
Stop Conditions
- Missing real image or dataset-directory path: ask for one.
- Path outside
--allowed-root: refuse that path and ask for a bounded path.
- User asks for many variants: render a small first batch before expanding.
Evidence Workflows
For evidence work, follow the generated pack README and use:
albu-mcp activation real-adoption-cycle
albu-mcp activation product-fix-closure-pipeline
albu-mcp evidence execution-pack --date YYYY-MM-DD --reviewer "Release operator" --output-dir evidence-session --format markdown
albu-mcp evidence execution-pack-audit --input-dir evidence-session
albu-mcp evidence execution-pack-progress --input-dir evidence-session
albu-mcp evidence execution-pack-status --input-dir evidence-session --format markdown --output evidence-session/status.md
albu-mcp evidence preflight
albu-mcp evidence import-wizard
If preview setup fails, read albumentationsx://diagnostics/guide, call diagnose_environment, then remediate before rendering.
1---2name: albumentationsx-mcp3description: Use when Codex needs to install, configure, or operate AlbumentationsX MCP from agent hosts for computer-vision augmentation previews, feedback-driven tuning, bounded local dataset review, or evidence-backed adoption workflows.4metadata:5 source: https://skillmd.com/skills/dkosarevsky/albumentationsx-mcp6---78# AlbumentationsX MCP910## Install1112```bash13uvx --from albumentationsx-mcp albumentationsx-mcp14```1516```bash17uvx --from albumentationsx-mcp albumentationsx-mcp \18 --allowed-root /absolute/path/to/images \19 --artifact-root /absolute/path/to/albu-artifacts20```2122## First Run Prompt2324Use this as the first host task:2526```text27Use AlbumentationsX MCP on image or directory `DATASET_PATH`. Read from `ALLOWED_ROOT` and write to `ARTIFACT_ROOT`. When the host exposes resource reads, read `albumentationsx://examples/client-smoke`; if resource reads are unavailable, call `get_workflow_example` with `example_id="client-smoke"`. Then call `run_host_smoke_check`. Continue only when `preview_ready` is true. If `preview_ready` is false, call `diagnose_environment` and stop before rendering. Then call `plan_dataset_onboarding`, `build_review_packet`, `validate_preview_request`, and `render_preview_batch`. Render at most 6 images on the first pass. Show the contact sheet path and ask for concrete feedback before `adjust_pipeline` or `export_pipeline`.28```2930## Host Config Hints3132- Codex plugin mode uses `.codex-plugin/plugin.json` and `.mcp.json`; its pinned server grants no user dataset root.33- Set `ALBU_MCP_ALLOWED_ROOTS` and `ALBU_MCP_ARTIFACT_ROOT`, or use explicit absolute host args. Never rely on the working directory.34- Restart, run `run_host_smoke_check`, and stop unless `allowed_roots` contains the intended root and `preview_ready` is true.3536## Host Workflow37381. Read `albumentationsx://examples/client-smoke`; if resource reads are unavailable, call `get_workflow_example` with `example_id="client-smoke"`.392. Call `run_host_smoke_check` next; continue only when `preview_ready` is true.403. Call `plan_dataset_onboarding`, then `build_review_packet` for one image or folder.414. Validate user paths with `validate_preview_request` before rendering.425. Render a small sample with `render_preview_batch`; inspect the contact sheet.436. Record feedback with `record_preview_feedback`, such as `too_noisy:high` or `exposure_too_weak`.447. `adjust_pipeline`, re-render, and compare before acceptance.458. Export only reviewed work with `export_pipeline` or requested report tools.4647## Safety Rules4849- Do not train, overwrite datasets, or fetch remote images.50- Keep private paths, filenames, and image contents out of public reports.51- Generated fixtures, contact sheets, and rehearsals are not beta evidence.52- Read only under `--allowed-root`; write only under `--artifact-root`.53- Re-run validation after changing paths, masks, bboxes, labels, or annotation formats.5455## Stop Conditions5657- Missing real image or dataset-directory path: ask for one.58- Path outside `--allowed-root`: refuse that path and ask for a bounded path.59- User asks for many variants: render a small first batch before expanding.6061## Evidence Workflows6263For evidence work, follow the generated pack README and use:6465- `albu-mcp activation real-adoption-cycle`66- `albu-mcp activation product-fix-closure-pipeline`67- `albu-mcp evidence execution-pack --date YYYY-MM-DD --reviewer "Release operator" --output-dir evidence-session --format markdown`68- `albu-mcp evidence execution-pack-audit --input-dir evidence-session`69- `albu-mcp evidence execution-pack-progress --input-dir evidence-session`70- `albu-mcp evidence execution-pack-status --input-dir evidence-session --format markdown --output evidence-session/status.md`71- `albu-mcp evidence preflight`72- `albu-mcp evidence import-wizard`7374If preview setup fails, read `albumentationsx://diagnostics/guide`, call `diagnose_environment`, then remediate before rendering.