lo-eyes

Visual frontend accessibility inspector MCP server. WCAG contrast checking, touch target validation, heading hierarchy audits, responsive screenshots, and S+ grading across mobile and desktop viewports.

Built by Like One Foundation (501(c)(3) nonprofit). Works with any site by changing BASE_URL.

Tools

Related MCP server: Refract

Device Presets

Audit Checks

• Overflow: Elements exceeding viewport width (respects scroll parents)

• Font size: Text below 12px minimum

• Touch targets: Interactive elements below Apple HIG 44px minimum

• Heading hierarchy: Skipped heading levels (h1 -> h3)

Grading

Setup

cd lo-eyes
python3 -m venv .venv
source .venv/bin/activate
pip install playwright mcp
python3 -m playwright install chromium

Usage

As MCP Server (Claude Code)

Add to .mcp.json:

{
  "mcpServers": {
    "lo-eyes": {
      "command": "/path/to/lo-eyes/.venv/bin/python3",
      "args": ["/path/to/lo-eyes/server.py"]
    }
  }
}

As CLI

./lo-eyes audit /                           # Audit homepage
./lo-eyes screenshot /blog/ --device ipad   # iPad screenshot
./lo-eyes scan / --device iphone-14         # Full-page chunked scan
./lo-eyes responsive /academy/              # All 5 viewports

Stack

• Python 3

• Playwright (headless Chromium)

• MCP SDK (FastMCP, stdio transport)

License

MIT

Built with love by Like One.