io.github.amitsingh-24/pixlint

PixLint

Lint, curate, and prepare computer-vision datasets — right from your AI assistant.

PixLint is an MCP server that gives AI assistants — Claude, Cursor, VS Code, and any MCP client — direct, conversational access to a complete computer-vision dataset toolkit: analyze quality, find duplicates and label errors, clean and curate, split, augment, convert formats, and export to every major training framework.

It runs locally over stdio, or self-hosted on the internet over authenticated HTTP.

Why PixLint

Most dataset tooling is either a paid SaaS or a heavy GUI app. PixLint is a single, open-source, self-hostable server an AI agent can drive end to end — and it does things others keep behind paid tiers:

• 🩺 Dataset Doctor — one call runs a full diagnostic and returns a prioritized, executable fix plan.
• Label-error detection — automatically surface images that are probably mislabeled.
• Natural-language query — "find blurry images with a person on the left", answered over your data.
• Weak-slice discovery — find under-represented or low-quality slices to collect or augment next.
• Curation that writes a new dataset — clean / filter / remap, not just report.
• Auto-labeling with a pretrained detector, and one-command Hugging Face publishing.

Features

103 operations — 67 tools, 23 resources, 13 prompts.

Quick Start

1. Install

pip install pixlint

Optional extras add heavier capabilities:

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

2. Connect your AI assistant

Claude Desktop — claude_desktop_config.json:

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

Cursor / VS Code — .cursor/mcp.json or .vscode/mcp.json:

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

CV_DATA_DIR is the directory PixLint is allowed to read datasets from.

3. Just ask

"Load my dataset at /data/coco_person, give it a readiness report, then clean it and export for YOLO."

Your assistant calls the right PixLint tools in sequence — diagnose, clean, split, export — and hands back a training-ready dataset.

Security

PixLint touches the filesystem and can be exposed to a network, so protections run on every tool call:

• Paths are confined to your configured data directory (reads and writes).
• Credentials come only from environment variables, never tool inputs.
• Per-call rate limiting, concurrency limits, and audit logging.
• Decompression-bomb protection on image decode.
• Optional bearer-token authentication for the HTTP transport.

See the Security Guide for the full threat model and the recommended production checklist.

Documentation

Runnable scripts live in examples/. See CHANGELOG.md for release notes.

License

PixLint is source-available under the PolyForm Strict License 1.0.0 — see LICENSE. You may use it for permitted (noncommercial) purposes; commercial use, redistribution, or modification requires a separate license from the copyright holder. Contributions are welcome via pull request.

mcp-name: io.github.amitsingh-24/pixlint