AlbumentationsX MCP — MCP-сервер для Claude Code
MCP-сервер для проверки датасетов, предпросмотра аугментаций и экспорта воспроизводимых пайплайнов. Подключается к Claude Code и другим MCP-хостам.
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Что делает AlbumentationsX MCP
AlbumentationsX MCP помогает агенту находить трансформации, проверять схемы и собирать превью для задач классификации, детекции, сегментации, OCR, bbox, масок и keypoint. Сервер умеет создавать контактные листы, накладывать аннотации, сравнивать запуски, ранжировать варианты и сохранять результат в Python, JSON или YAML.
Внутри есть проверка пайплайнов на CPU torch.Tensor, структурированная обратная связь и текстовый режим для хостов без MCP Apps. Для запуска через Claude Code достаточно команды claude mcp add albu-mcp -- uvx albumentationsx-mcp; рабочие каталоги можно ограничить переменными окружения. Сервер читает только пути из --allowed-root, а созданные файлы складывает в --artifact-root.
Сервер не выполняет произвольный Python, не загружает изображения из сети, не меняет исходные датасеты и не обучает модели. Профиль review требует отдельного сценария проверки и рендеринга, тогда как run_first_preview работает с профилем full или dataset. Это важно учесть при настройке первого превью.
Какие задачи решает
- проверить аугментации на примерах датасета
- сравнить варианты превью контактными листами
- просмотреть маски и другие аннотации
- экспортировать принятый пайплайн в Python, JSON или YAML
- проверить пайплайн
torch.Tensorна CPU
Примеры запросов агенту
- Проверь датасет в
/absolute/path/to/images, создай первое превью с низкой интенсивностью и покажи контактный лист. - Сравни варианты аугментаций и отклони результат с меткой
too_noisy:high. - Проверь окружение, а затем вызови
trace_preview_variantдля выбранного результата перед изменением пайплайна.
Как установить AlbumentationsX MCP
Командой платформы
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Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from albumentationsx-mcp <команда>
Командой платформы
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Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from albumentationsx-mcp <команда>
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from albumentationsx-mcp <команда>
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from albumentationsx-mcp <команда>
Командой платформы
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Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from albumentationsx-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о AlbumentationsX MCP
Как установить AlbumentationsX MCP в Claude Code?
Выполните claude mcp add albu-mcp -- uvx albumentationsx-mcp. После этого подключите сервер в Claude Code.
Что делает AlbumentationsX MCP?
Он помогает исследовать датасеты, просматривать и сравнивать варианты аугментаций, проверять аннотации и экспортировать воспроизводимые пайплайны.
Какие ограничения есть у AlbumentationsX MCP?
Сервер читает только разрешённые пути, сохраняет файлы в каталоге артефактов и не запускает произвольный Python, не скачивает изображения и не обучает модели.
