English Français العربية

lo-eyes

Official registry Security

Visual accessibility inspector. WCAG contrast, touch targets, heading audits, screenshots.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package lo-eyes
Claude Code 
claude mcp add lo-eyes -- uvx lo-eyes==1.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "lo-eyes": {
            "command": "uvx",
            "args": [
                "lo-eyes==1.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. lo-eyes
  2. Tools
  3. Device Presets
  4. Audit Checks
  5. Grading
  6. Setup
  7. Usage
  8. Stack
  9. License

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

ToolDescription
eyes_screenshotViewport-sized screenshot at any device preset
eyes_scanAuto-chunk full page into readable viewport pieces with RAG manifest
eyes_auditResponsive + accessibility audit with S+ grading
eyes_devicesList available device presets

Device Presets

NameViewportType
iphone-se375x667Mobile
iphone-14390x844Mobile
ipad768x1024Tablet
laptop1280x800Desktop
desktop1440x900Desktop

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

GradeCriteria
S+Zero issues
A1-5 medium, zero high
B6+ medium, zero high
C1-2 high
D3-5 high
F6+ high

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

License

MIT

Built with love by Like One.

Frequently asked questions

What is lo-eyes?

Visual accessibility inspector. WCAG contrast, touch targets, heading audits, screenshots.

How do I install lo-eyes?

It runs on your machine. In Claude Code: claude mcp add lo-eyes -- uvx lo-eyes==1.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does lo-eyes need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is lo-eyes open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains lo-eyes?

It is published by sophiacave. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.