mcpField
A
AlbumentationsX MCP

AlbumentationsX MCP

本地服务
github.com开发工具611 周前更新
代码仓库访问官网

关于 AlbumentationsX MCP

AlbumentationsX MCP 是用于检查图像数据集、预览和比较增强结果，以及导出可复现流水线的服务端。它面向数据集与模型工作流审查，支持可视化反馈并限制本地文件访问范围。

主要功能

  1. 01发现变换并验证流水线
  2. 02预览批次并生成联系表
  3. 03比较、排序并报告预览结果
  4. 04审查标注和分割掩码
  5. 05导出为 Python、JSON 或 YAML
  6. 06通过 MCP Apps 进行交互审查

适用场景

  1. 01验收流水线前检查图像增强结果
  2. 02审查分割掩码和标注叠加效果
  3. 03比较鲁棒性变体并导出选定流水线

MCP 相关

向 MCP 主机提供 AlbumentationsX 数据集、预览、审查、验证和导出工作流。支持通过 MCP Apps 审查，其他主机可使用纯文本回退方式。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "dkosarevsky-albu": {
      "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 albumentationsx-mcp
需要配置的环境变量
ALBU_MCP_ALLOWED_ROOTSOptional os.pathsep-separated allowlist of local roots that preview inputs and masks may be read from.
ALBU_MCP_ARTIFACT_ROOTOptional local directory where generated preview artifacts and manifests are written.
ALBU_MCP_MAX_PREVIEW_RUNSOptional retention limit for indexed preview runs. Defaults to 100.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypialbumentationsx-mcp1.21.1

工具

47

收录的工具列表 · 更新于 2 周前

参数类型必填说明
requestobject是

详细介绍

AlbumentationsX MCP

AlbumentationsX 的模型上下文协议服务：检查数据集、预览增强效果、借助视觉反馈优化增强，并导出可复现的流水线。

CI PyPI Python MCP Registry skills.sh

AlbumentationsX 基线与调整后的预览联系表

让 MCP 宿主生成多个鲁棒性变体，拒绝 too_noisy:high 这类过度增强结果，比较调整后的批次预览，并导出通过验收的流水线。

安装

Claude Desktop

下载最新的 albumentationsx-mcp.mcpb，在 Settings -> Extensions -> Advanced settings 中安装，并选择单独的图像目录和制品目录。

其他 MCP 宿主

运行已发布的服务，并限制其本地访问范围：

uvx --from albumentationsx-mcp albumentationsx-mcp \
  --allowed-root /absolute/path/to/images \
  --artifact-root /absolute/path/to/albu-artifacts

run_first_preview 需要使用默认的 full 或 dataset 能力配置文件。较小的 review 配置文件需按照使用指南显式采用验证／渲染回退方案；也可以重启服务并使用 dataset 或 full。请参阅配置。可复制的宿主配置见安装指南。 仓库还包含原生 Codex 插件包。npx skills add dKosarevsky/albu-mcp 安装的是 Agent 指南，而不是 MCP 服务。

首次预览

连接服务后，向宿主发出请求：

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 会返回 preview_ready 和 preview_request_template。如果无法读取资源，请调用 get_workflow_example 并设置 example_id="client-smoke"。

试试分类鲁棒性用例，或参阅前 10 分钟指南。validate_preview_request 回退方案、批量预览以及预览运行的比较方法见使用指南。使用 too_noisy:high 或 exposure_too_weak:medium，然后可选择通过首次预览反馈分享一轮脱敏后的迭代。 如果设置失败，请阅读 albumentationsx://diagnostics/guide，并调用 diagnose_environment 获取范围受限的修复操作。

功能

  • 转换操作发现、架构、配方和流水线验证。
  • 分类、检测、分割、OCR、边界框、掩码、关键点和数据集质量工作流。
  • 确定性预览、联系表、标注叠加、比较、排序和报告。
  • 交互式 MCP Apps 审核，并为其他宿主提供纯文本回退方案。
  • 结构化反馈、调优会话，以及 Python、JSON 或 YAML 导出。
  • 支持运行时的 CPU torch.Tensor 流水线验证和受控的 Python 交接。
  • 支持 MCP 2026-07-28 及旧版协商；提供稳定的 Agent 工作流资源、诊断信息和契约快照。

该服务不会执行任意 Python、获取远程图像、覆盖数据集或训练模型。读取范围由 --allowed-root 限定；生成的文件保存在 --artifact-root 下。

集成

文档

开发

uv sync --all-extras --dev
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run ty check

采用 AGPL-3.0-or-later 许可。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。