lo-eyes
Visual accessibility inspector. WCAG contrast, touch targets, heading audits, screenshots.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
lo-eyesclaude mcp add lo-eyes -- uvx lo-eyes==1.1.0
{
"mcpServers": {
"lo-eyes": {
"command": "uvx",
"args": [
"lo-eyes==1.1.0"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
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
| Tool | Description |
|---|---|
eyes_screenshot | Viewport-sized screenshot at any device preset |
eyes_scan | Auto-chunk full page into readable viewport pieces with RAG manifest |
eyes_audit | Responsive + accessibility audit with S+ grading |
eyes_devices | List available device presets |
Device Presets
| Name | Viewport | Type |
|---|---|---|
iphone-se | 375x667 | Mobile |
iphone-14 | 390x844 | Mobile |
ipad | 768x1024 | Tablet |
laptop | 1280x800 | Desktop |
desktop | 1440x900 | Desktop |
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
| Grade | Criteria |
|---|---|
| S+ | Zero issues |
| A | 1-5 medium, zero high |
| B | 6+ medium, zero high |
| C | 1-2 high |
| D | 3-5 high |
| F | 6+ 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
- Python 3
- Playwright (headless Chromium)
- MCP SDK (FastMCP, stdio transport)
License
MIT
Built with love by Like One.
الأسئلة الشائعة
ما هو lo-eyes؟
Visual accessibility inspector. WCAG contrast, touch targets, heading audits, screenshots.
كيف أثبّت lo-eyes؟
يعمل على جهازك. في Claude Code: claude mcp add lo-eyes -- uvx lo-eyes==1.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج lo-eyes إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل lo-eyes مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون lo-eyes؟
ينشره sophiacave. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.