O
Opitien/Viewport-iq
Production-grade Browser Inspection & Responsive Layout Testing MCP Server for AI Assistants
更新 2026-11-14
在 GitHub 查看 ↗直链 · 无中转页
我们没有从该仓库取到可核对的安装命令,也没有公开的远端端点。这两样都没有时,我们不出配置——编一条出来比不给更糟。 各客户端的接法 →
- ★ 数取值
- 0 ★ · Opitien/Viewport-iq · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
- 收录与活跃
- 收录于 2026-11-18 · 最近见到 2026-11-20 · 共见到 3 次 · 被 3 个来源列出
- 评分构成
- 综合分 300 · 3 个来源 · mcp
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
Opitien/Viewport-iq;我们收录于 2026-11-18;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
Production-grade Browser Inspection & Responsive Layout Testing MCP Server f
以下摘录自该仓库的 README(片段)
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
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/opitien-viewport-iq/)
- 来源
- awesome · https://github.com/Opitien/Viewport-iq
- 按领域浏览
- MCP 服务
- 收录来源
- 3 个独立来源
- 收录于
- 今天
更多 MCP 服务器
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。