AlbumentationsX MCP
Model Context Protocol server for AlbumentationsX: inspect datasets, preview augmentations, refine them with visual feedback, and export reproducible pipelines.
Ask an MCP host for several robustness variants, reject an excessive result such as too_noisy:high, compare the adjusted batch previews, and export the accepted pipeline.
Install
Claude Desktop
Download the latest albumentationsx-mcp.mcpb, install it from Settings -> Extensions -> Advanced settings, and select separate image and artifact directories.
Other MCP Hosts
Run the published server with bounded local access:
uvx --from albumentationsx-mcp albumentationsx-mcp \
--allowed-root /absolute/path/to/images \
--artifact-root /absolute/path/to/albu-artifacts
run_first_preview requires the default full or dataset capability profile. The smaller review profile uses the
explicit validate/render fallback in the usage guide, or you can restart with dataset or full; see
configuration. Copyable host configurations are in the install guide.
The repository also contains a native Codex plugin bundle. npx skills add dKosarevsky/albu-mcp installs agent guidance, not the MCP server.
First Preview
After connecting the server, ask your host:
Run the host smoke check. If preview_ready is true, call run_first_preview for /absolute/path/to/images with low
intensity and at most 8 images. Show me the contact sheet. When I mention a specific result, call
trace_preview_variant before adjusting it.
run_host_smoke_check returns preview_ready and a preview_request_template. If resource reads are unavailable, call
get_workflow_example with example_id="client-smoke".
Follow the First 10 Minutes guide. Detailed guided and advanced workflows, including the
explicit validate_preview_request fallback, batch previews, and how to compare preview runs, are in
Usage. Give concrete feedback such as too_noisy:high or exposure_too_weak:medium before accepting a
result.
If setup fails, read albumentationsx://diagnostics/guide and call diagnose_environment for bounded remediation actions.
Capabilities
- Transform discovery, schemas, recipes, and pipeline validation.
- Classification, detection, segmentation, OCR, bbox, mask, keypoint, and dataset-quality workflows.
- Deterministic previews, contact sheets, annotation overlays, comparison, ranking, and reports.
- Interactive MCP Apps review with a text-only fallback for other hosts.
- Structured feedback, tuning sessions, and Python, JSON, or YAML export.
- Stable agent workflow resources, prompts, diagnostics, and reviewed contract snapshots.
The server does not execute arbitrary Python, fetch remote images, overwrite datasets, or train models. Reads are restricted by --allowed-root; generated files stay under --artifact-root.
Integrations
- Official Albumentations MCP guide
- Official MCP Registry entry
- skills.sh agent skill
- Upstream documentation PR
Documentation
- Install and host configuration
- Runtime settings and capability profiles
- First 10 minutes
- Usage and recipes
- MCP Apps review and compatibility policy
- Documentation index
- CHANGELOG.md
- server.json: public MCP Registry metadata.
Development
uv sync --all-extras --dev
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run ty check
Licensed under AGPL-3.0-or-later.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file albumentationsx_mcp-1.20.0.tar.gz.
File metadata
- Download URL: albumentationsx_mcp-1.20.0.tar.gz
- Upload date:
- Size: 1.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aa1e4ca717ed7130efd3425224821293ae0f357ee5894afe7d789ec226090551
|
|
| MD5 |
446803f49bae944bc96270e6cd1281ae
|
|
| BLAKE2b-256 |
e2fa173da67f7da21b1d52287a10f0892506d3ae94e9d46809c5db5cab3127d4
|
File details
Details for the file albumentationsx_mcp-1.20.0-py3-none-any.whl.
File metadata
- Download URL: albumentationsx_mcp-1.20.0-py3-none-any.whl
- Upload date:
- Size: 392.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f57dd8951f98a28a58648de2ef5c4226ec08151c210352691c7a4aac33ae68f6
|
|
| MD5 |
263bd8bbc72d887f55bc9190f72135cc
|
|
| BLAKE2b-256 |
3725e23868d6e592d2135ac10a4849c4451b19c3fcde359023fa281493f78fc0
|
