pixlint

PixLint

直接通过 AI 助手检查、整理并准备计算机视觉数据集。

PixLint 是一个 MCP 服务，可让 AI 助手（Claude、Cursor、VS Code 及任何 MCP 客户端）直接以对话方式使用完整的计算机视觉数据集工具包：分析质量、查找重复项和标签错误、清理和整理、拆分、增强、转换格式，并导出到所有主流训练框架。

它可通过 stdio 在本地运行，也可通过经过身份验证的 HTTP 在互联网上自托管。

---

为什么选择 PixLint

大多数数据集工具要么是付费 SaaS，要么是笨重的 GUI 应用。PixLint 是一个单一的开源、可自托管服务，AI Agent 可端到端驱动；它还提供了其他工具往往只在付费版中提供的功能：

• 🩺 数据集医生 — 一次调用即可执行完整诊断，并返回按优先级排序、可执行的修复计划。
• 标签错误检测 — 自动找出可能标错标签的图像。
• 自然语言查询 — “查找左侧有人物的模糊图像”，直接搜索你的数据。
• 薄弱子集发现 — 找出代表性不足或质量较低的子集，以便后续采集或增强。
• 生成新数据集的整理功能 — 清理／筛选／重新映射，而不只是生成报告。
• 自动标注（使用预训练检测器），以及一键发布到 Hugging Face。

---

功能

103 项操作 — 67 个工具、23 个资源、13 个提示词。

类别	提供的功能
加载	COCO · VOC · YOLO · KITTI · 文件夹，以及云存储（S3 / GCS / Azure）
分析	重复项 · 质量（模糊度／曝光／噪声／对比度）· 完整性 · 类别分布 · 嵌入 · 语义搜索 · 离群项 · 健康评分
数据智能	数据集医生就绪度报告 · 标签错误检测 · 自然语言查询 · 薄弱子集／偏差发现
整理	筛选出子集 · 清理（损坏／越界／退化／重复项）· 重新映射类别 — 每项操作都会生成新数据集
增强与转换	YOLO／分类／分割工作流 · 调整大小 · 归一化 · 格式转换
拆分	分层／随机／按时间／分组 · k 折 · 数据泄漏检测
自动标注	预训练 COCO-80 检测器 → 预标注数据集
导出与发布	PyTorch · TensorFlow · Ultralytics · HDF5 · WebDataset · FiftyOne · CVAT · LabelMe · Hugging Face Hub
流水线	组合多步工作流并复用预构建模板

---

快速开始

1. 安装

pip install pixlint

可选扩展可添加更强大的功能：

pip install "pixlint[torch]"        # embeddings, auto-labeling, label-error detection
pip install "pixlint[huggingface]"  # Hugging Face export + publishing
pip install "pixlint[all]"          # everything

2. 连接你的 AI 助手

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "pixlint": {
      "command": "pixlint",
      "env": { "CV_DATA_DIR": "/path/to/your/datasets" }
    }
  }
}

Cursor / VS Code — .cursor/mcp.json 或 .vscode/mcp.json：

{
  "mcpServers": {
    "pixlint": {
      "command": "pixlint",
      "env": { "CV_DATA_DIR": "/path/to/your/datasets" }
    }
  }
}

CV_DATA_DIR 是 PixLint 获准读取数据集的目录。

3. 直接提问

“加载我在 /data/coco_person 的数据集，为它生成就绪度报告，然后清理并导出为 YOLO 格式。”

你的助手会依次调用合适的 PixLint 工具——诊断、清理、拆分、导出——并提供可用于训练的数据集。

---

安全

PixLint 会访问文件系统，并可能暴露在网络中，因此每次工具调用都会执行以下保护措施：

• 路径限制在已配置的数据目录内（读取和写入均如此）。
• 凭据仅从环境变量获取，绝不通过工具输入传入。
• 对每次调用进行速率限制、并发限制和审计日志记录。
• 图像解码时防范解压炸弹。
• HTTP 传输支持可选的 Bearer 令牌身份验证。

完整威胁模型和推荐的生产环境检查清单，请参阅安全指南。

---

文档

指南	说明
快速入门	安装、配置和入门步骤
MCP 客户端设置	Claude、Cursor、VS Code，以及远程/HTTP 托管
API 参考	全部 67 个工具及其参数
安全指南	威胁模型、配置和托管
管道模板	预构建和自定义管道

可运行脚本位于 examples/。发行说明请参阅 CHANGELOG.md。

---

许可证

PixLint 根据 PolyForm Strict License 1.0.0 以源代码可用的形式提供——请参阅 LICENSE。 您可以将其用于许可允许的（非商业）用途；商业使用、再分发或修改均需获得版权所有者的单独许可。欢迎通过拉取请求贡献代码。

---

_{mcp-name: io.github.amitsingh-24/pixlint}