O
Opitien/Viewport-iq
Production-grade Browser Inspection & Responsive Layout Testing MCP Server for AI Assistants
updated 2026-11-14
View on GitHub ↗Direct link · no redirect page
We have neither an install command nor a public remote endpoint from this repository, so we do not print a config. A made-up one is worse than none. How each client wires MCP up →
- Star count
- 0 ★ · Opitien/Viewport-iq · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
Opitien/Viewport-iq;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
Production-grade Browser Inspection & Responsive Layout Testing MCP Server f
Excerpted from the repository README (abridged)
Equips Claude Desktop, Cursor, Cline, and other MCP clients with deep DOM inspection, multi-viewport layout validation, overflow detection, and visual pixel-diff analysis via Playwright Chromium.
## Table of Contents
1. Key Capabilities
2. Architecture
3. Prerequisites & Installation
4. Client Configuration
Claude Desktop
Cursor / Windsurf / Cline
5. Complete MCP Tool Reference
A. Browser Navigation
B. Page & DOM Inspection
C. Responsive Testing & Breakpoints
D. Visual Comparison & Screenshots
E. Layout Audit
F. Console & Network Diagnostics
6. Organized Output Structure
7. Practical Workflow Examples
8. Automated Test Suite & Fixtures
9. Troubleshooting & Best Practices
10. Roadmap
## Key Capabilities
Automated Multi-Viewport Testing: Validates layouts across 7 standard presets (320px Small Mobile to 1920px Ultrawide Desktop) or custom dimensions.
Evidence-Based Overflow Detection: Identifies horizontal page overflow, unconstrained fixed widths, media overflow, and text clipping with exact pixel measurements.
Visual Viewport Comparison & Pixel Diffing: Captures synchronized screenshots across device profiles and highlights responsive shifts using image diff analysis (pixelmatch).
Semantic DOM & Computed CSS: Inspects landmarks, heading hierarchies (h1-h6), accessible names, box models, flex/grid properties, and layout transitions.
Layout Health Audit: Grades pages with a 0–100 health score and classifies issues by severity (Critical, High, Medium, Low).
Real-Time Console & Network Diagnostics: Intercepts uncaught JavaScript exceptions, console warnings, and failed HTTP requests (4xx/5xx) while protecting sensitive credentials.
Robust Session Management: Single persistent Playwright Chromium instance with lifecycle handling and graceful recovery.
Strict Protocol Compliance: Emits all diagnostic logs exclusively to stderr, preserving stdout for JSON-RPC MCP communication.
## Architecture
ViewportIQ adheres to a clean, decoupled modular architecture separating browser automation, MCP tool registration, inspection logic, and report generation:
viewport-iq/
├── src/
│ ├── index.ts # CLI executable entry point
│ ├── server.ts # MCP Server initialization & tool registration
│ ├── browser/
│ │ ├── browser-manager.ts # Singleton Playwright browser & context lifecycle
│ │ ├── page-manager.ts # Active page state, console & network interception
│ │ └── navigation.ts # URL navigation, history, and reload
│ ├── tools/
│ │ ├── navigation.tools.ts # open_page, navigate_back, reload_page, etc.
│ │ ├── page-inspection.tools.ts # inspect_page, inspect_element, inspect_styles
│ │ ├── responsive.tools.ts # test_responsiveness, detect_overflow, etc.
│ │ ├── visual-comparison.tools.ts # compare_viewports, capture_screenshot
│ │ ├── layout-audit.tools.ts # audit_layout
│ │ ├── console.tools.ts # inspect_console
│ │ └── network.tools.ts # inspect_network
│ ├── services/
│ │ ├── dom-inspector.ts # Semantic landmarks, headings, images, forms
│ │ ├── css-inspector.ts # Computed styles, box-model, flex/grid layout
│ │ ├── overflow-detector.ts # Horizontal overflow & clipping analysis
│ │ ├── responsive-analyzer.ts # Multi-viewport sweep & breakpoint probing
## Table of Contents
1. Key Capabilities
2. Architecture
3. Prerequisites & Installation
4. Client Configuration
Claude Desktop
Cursor / Windsurf / Cline
5. Complete MCP Tool Reference
A. Browser Navigation
B. Page & DOM Inspection
C. Responsive Testing & Breakpoints
D. Visual Comparison & Screenshots
E. Layout Audit
F. Console & Network Diagnostics
6. Organized Output Structure
7. Practical Workflow Examples
8. Automated Test Suite & Fixtures
9. Troubleshooting & Best Practices
10. Roadmap
## Key Capabilities
Automated Multi-Viewport Testing: Validates layouts across 7 standard presets (320px Small Mobile to 1920px Ultrawide Desktop) or custom dimensions.
Evidence-Based Overflow Detection: Identifies horizontal page overflow, unconstrained fixed widths, media overflow, and text clipping with exact pixel measurements.
Visual Viewport Comparison & Pixel Diffing: Captures synchronized screenshots across device profiles and highlights responsive shifts using image diff analysis (pixelmatch).
Semantic DOM & Computed CSS: Inspects landmarks, heading hierarchies (h1-h6), accessible names, box models, flex/grid properties, and layout transitions.
Layout Health Audit: Grades pages with a 0–100 health score and classifies issues by severity (Critical, High, Medium, Low).
Real-Time Console & Network Diagnostics: Intercepts uncaught JavaScript exceptions, console warnings, and failed HTTP requests (4xx/5xx) while protecting sensitive credentials.
Robust Session Management: Single persistent Playwright Chromium instance with lifecycle handling and graceful recovery.
Strict Protocol Compliance: Emits all diagnostic logs exclusively to stderr, preserving stdout for JSON-RPC MCP communication.
## Architecture
ViewportIQ adheres to a clean, decoupled modular architecture separating browser automation, MCP tool registration, inspection logic, and report generation:
viewport-iq/
├── src/
│ ├── index.ts # CLI executable entry point
│ ├── server.ts # MCP Server initialization & tool registration
│ ├── browser/
│ │ ├── browser-manager.ts # Singleton Playwright browser & context lifecycle
│ │ ├── page-manager.ts # Active page state, console & network interception
│ │ └── navigation.ts # URL navigation, history, and reload
│ ├── tools/
│ │ ├── navigation.tools.ts # open_page, navigate_back, reload_page, etc.
│ │ ├── page-inspection.tools.ts # inspect_page, inspect_element, inspect_styles
│ │ ├── responsive.tools.ts # test_responsiveness, detect_overflow, etc.
│ │ ├── visual-comparison.tools.ts # compare_viewports, capture_screenshot
│ │ ├── layout-audit.tools.ts # audit_layout
│ │ ├── console.tools.ts # inspect_console
│ │ └── network.tools.ts # inspect_network
│ ├── services/
│ │ ├── dom-inspector.ts # Semantic landmarks, headings, images, forms
│ │ ├── css-inspector.ts # Computed styles, box-model, flex/grid layout
│ │ ├── overflow-detector.ts # Horizontal overflow & clipping analysis
│ │ ├── responsive-analyzer.ts # Multi-viewport sweep & breakpoint probing
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/opitien-viewport-iq/)
- Source
- awesome · https://github.com/Opitien/Viewport-iq
- Browse by field
- MCP servers
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.