safari-devtools-mcp 1.7.0 → 1.8.1

package/README.md

@@ -208,7 +208,7 @@ The server exposes guided debugging workflows as MCP prompts. Clients that suppo
 | `safari-specific-debugging` | Debug WebKit quirks — CSS prefixes, JS feature gaps, ITP/CORS issues             |
 | `performance-debugging`     | Performance analysis — Navigation Timing, Core Web Vitals, resource waterfall    |
 
-## Tools (41)
+## Tools (45)
 
 ### Debugging
 
@@ -286,6 +286,15 @@ The server exposes guided debugging workflows as MCP prompts. Clients that suppo
 | `press_key`     | Press a key or combination (e.g., `Meta+A`, `Enter`) |
 | `upload_file`   | Upload a file through a file input                   |
 
+### iOS Safari validation
+
+| Tool                          | Description                                                                                                    |
+| ----------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `inspect_viewport_meta`       | Parse the viewport meta tag and validate against iOS best practices (width, zoom, viewport-fit)                |
+| `get_safe_area_insets`        | Read CSS safe-area-inset values and check whether the page handles notched devices correctly                   |
+| `check_ios_web_app_readiness` | Audit the page for Add to Home Screen / PWA readiness (apple-touch-icon, manifest, splash screens, status bar) |
+| `check_webkit_compatibility`  | Check page CSS against the live Safari session via CSS.supports()                                              |
+
 ## Architecture
 
 ```

package/build/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAqC/C,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAAkB,GAAG;IAClE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB,CA2CA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAyC/C,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAAkB,GAAG;IAClE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB,CA2CA"}

package/build/src/index.js

@@ -22,6 +22,8 @@ import { tools as cookieTools } from './tools/cookies.js';
 import { tools as storageTools } from './tools/storage.js';
 import { tools as inputTools } from './tools/input.js';
 import { tools as emulationTools, deviceTools } from './tools/emulation.js';
+import { tools as iosValidationTools } from './tools/ios-validation.js';
+import { tools as webkitCompatTools } from './tools/webkit-compat.js';
 const allTools = [
     ...consoleTools,
     ...networkTools,
@@ -37,6 +39,8 @@ const allTools = [
     ...inputTools,
     ...emulationTools,
     ...deviceTools,
+    ...iosValidationTools,
+    ...webkitCompatTools,
 ];
 export function createSafariMcpServer(options = {}) {
     const { slim = false } = options;

package/build/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/build/src/tools/ios-validation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * iOS Safari validation tools.
+ *
+ * Inspect viewport meta tags, safe-area insets, and PWA readiness —
+ * the three things every iOS Safari developer has to fight with.
+ */
+export declare const tools: import("./types.js").ToolDef<import("zod").ZodRawShape>[];
+//# sourceMappingURL=ios-validation.d.ts.map

package/build/src/tools/ios-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-validation.d.ts","sourceRoot":"","sources":["../../../src/tools/ios-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyEH,eAAO,MAAM,KAAK,2DA6QjB,CAAC"}

package/build/src/tools/ios-validation.js

@@ -0,0 +1,282 @@
+/**
+ * iOS Safari validation tools.
+ *
+ * Inspect viewport meta tags, safe-area insets, and PWA readiness —
+ * the three things every iOS Safari developer has to fight with.
+ */
+import { defineTool } from './types.js';
+function analyzeViewport(attrs) {
+    const issues = [];
+    if (Object.keys(attrs).length === 0) {
+        return [
+            {
+                severity: 'error',
+                message: 'No viewport meta tag found. iOS Safari will render at 980px width and scale down.',
+            },
+        ];
+    }
+    if (!attrs.width) {
+        issues.push({
+            severity: 'error',
+            message: 'Missing "width=device-width". Without this, Safari uses a default 980px layout width.',
+        });
+    }
+    else if (attrs.width !== 'device-width') {
+        issues.push({
+            severity: 'warning',
+            message: `width="${attrs.width}" — consider using "device-width" for responsive layouts.`,
+        });
+    }
+    if (!attrs['initial-scale']) {
+        issues.push({
+            severity: 'warning',
+            message: 'Missing "initial-scale=1". Some iOS Safari versions may not zoom correctly without it.',
+        });
+    }
+    if (attrs['user-scalable'] === 'no' || attrs['maximum-scale'] === '1') {
+        issues.push({
+            severity: 'error',
+            message: 'Zoom is disabled (user-scalable=no or maximum-scale=1). This is an accessibility violation (WCAG 1.4.4) and Safari 10+ ignores it anyway.',
+        });
+    }
+    if (attrs['viewport-fit'] !== 'cover') {
+        issues.push({
+            severity: 'warning',
+            message: 'Missing "viewport-fit=cover". Required for safe-area-inset-* CSS env() values to work on notched devices (iPhone X+).',
+        });
+    }
+    if (attrs['minimum-scale'] && parseFloat(attrs['minimum-scale']) < 1) {
+        issues.push({
+            severity: 'info',
+            message: `minimum-scale=${attrs['minimum-scale']}. Values below 1 allow zoom-out on iOS, which can cause layout issues.`,
+        });
+    }
+    return issues;
+}
+// ---- Tools ----
+export const tools = [
+    defineTool({
+        name: 'inspect_viewport_meta',
+        description: 'Parse the viewport meta tag and validate it against iOS Safari ' +
+            'best practices. Reports issues like missing width=device-width, ' +
+            'disabled zoom (accessibility violation), missing viewport-fit=cover ' +
+            'for safe areas, and other common misconfiguration.',
+        slimDescription: 'Validate iOS viewport meta tag.',
+        schema: {},
+        handler: async (_params, driver) => {
+            const result = await driver.runScript(`(() => {
+        const meta = document.querySelector('meta[name="viewport"]');
+        if (!meta) return { content: null, attrs: {} };
+        const content = meta.getAttribute('content') || '';
+        const attrs = {};
+        for (const part of content.split(',')) {
+          const [key, val] = part.split('=').map(s => s.trim());
+          if (key) attrs[key] = val || '';
+        }
+        return { content, attrs };
+      })()`);
+            const issues = analyzeViewport(result.attrs);
+            const lines = [];
+            if (result.content) {
+                lines.push(`Viewport meta: ${result.content}`);
+            }
+            else {
+                lines.push('⚠ No <meta name="viewport"> tag found.');
+            }
+            lines.push('');
+            if (issues.length === 0) {
+                lines.push('✅ No issues found. Viewport is correctly configured for iOS Safari.');
+            }
+            else {
+                const errors = issues.filter(i => i.severity === 'error');
+                const warnings = issues.filter(i => i.severity === 'warning');
+                const infos = issues.filter(i => i.severity === 'info');
+                if (errors.length > 0) {
+                    lines.push('Errors:');
+                    for (const i of errors)
+                        lines.push(`  ❌ ${i.message}`);
+                }
+                if (warnings.length > 0) {
+                    lines.push('Warnings:');
+                    for (const i of warnings)
+                        lines.push(`  ⚠ ${i.message}`);
+                }
+                if (infos.length > 0) {
+                    lines.push('Info:');
+                    for (const i of infos)
+                        lines.push(`  ℹ ${i.message}`);
+                }
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        },
+    }),
+    defineTool({
+        name: 'get_safe_area_insets',
+        description: 'Read the current CSS safe-area-inset values (top, right, bottom, left) ' +
+            'as seen by the page. These are non-zero on notched iPhones when ' +
+            'viewport-fit=cover is set. Also checks whether the page uses ' +
+            'env(safe-area-inset-*) in its stylesheets.',
+        slimDescription: 'Get iOS safe area inset values.',
+        schema: {},
+        handler: async (_params, driver) => {
+            const result = await driver.runScript(`(() => {
+        // Read computed env() values via a probe element
+        const probe = document.createElement('div');
+        probe.style.cssText =
+          'position:fixed;top:env(safe-area-inset-top,0px);' +
+          'right:env(safe-area-inset-right,0px);' +
+          'bottom:env(safe-area-inset-bottom,0px);' +
+          'left:env(safe-area-inset-left,0px);' +
+          'pointer-events:none;visibility:hidden;';
+        document.body.appendChild(probe);
+        const cs = getComputedStyle(probe);
+        const insets = {
+          top: cs.top, right: cs.right,
+          bottom: cs.bottom, left: cs.left,
+        };
+        probe.remove();
+
+        // Check viewport-fit=cover
+        const meta = document.querySelector('meta[name="viewport"]');
+        const viewportFitCover = meta
+          ? (meta.getAttribute('content') || '').includes('viewport-fit=cover')
+          : false;
+
+        // Scan stylesheets for env(safe-area-inset usage
+        let usedInCSS = false;
+        try {
+          for (const sheet of document.styleSheets) {
+            try {
+              const text = [...sheet.cssRules].map(r => r.cssText).join(' ');
+              if (text.includes('safe-area-inset')) { usedInCSS = true; break; }
+            } catch {}
+          }
+        } catch {}
+
+        return { insets, viewportFitCover, usedInCSS };
+      })()`);
+            const lines = ['Safe area insets:'];
+            lines.push(`  top: ${result.insets.top}`);
+            lines.push(`  right: ${result.insets.right}`);
+            lines.push(`  bottom: ${result.insets.bottom}`);
+            lines.push(`  left: ${result.insets.left}`);
+            lines.push('');
+            if (!result.viewportFitCover) {
+                lines.push('⚠ viewport-fit=cover is NOT set. Safe area insets will always be 0 ' +
+                    'even on notched devices. Add viewport-fit=cover to your viewport meta tag.');
+            }
+            else {
+                lines.push('✅ viewport-fit=cover is set.');
+            }
+            lines.push(result.usedInCSS
+                ? '✅ env(safe-area-inset-*) found in stylesheets.'
+                : '⚠ env(safe-area-inset-*) not found in any stylesheet. Content may be obscured by the notch/home indicator.');
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        },
+    }),
+    defineTool({
+        name: 'check_ios_web_app_readiness',
+        description: 'Audit the page for iOS Safari "Add to Home Screen" / PWA readiness. ' +
+            'Checks apple-touch-icon, apple-mobile-web-app-capable, status bar style, ' +
+            'theme-color, manifest link, and splash screen configuration.',
+        slimDescription: 'Audit iOS PWA/home screen readiness.',
+        schema: {},
+        handler: async (_params, driver) => {
+            const result = await driver.runScript(`(() => {
+        const getMeta = (name) => {
+          const el = document.querySelector('meta[name="' + name + '"]');
+          return el ? el.getAttribute('content') : null;
+        };
+        const getLink = (rel) => {
+          const el = document.querySelector('link[rel="' + rel + '"]');
+          return el ? el.getAttribute('href') : null;
+        };
+
+        const touchIcons = [...document.querySelectorAll('link[rel="apple-touch-icon"]')].map(el => ({
+          sizes: el.getAttribute('sizes') || 'unspecified',
+          href: el.getAttribute('href') || '',
+        }));
+
+        const splashScreens = document.querySelectorAll('link[rel="apple-touch-startup-image"]').length;
+
+        return {
+          capable: getMeta('apple-mobile-web-app-capable'),
+          statusBarStyle: getMeta('apple-mobile-web-app-status-bar-style'),
+          themeColor: getMeta('theme-color'),
+          manifestHref: getLink('manifest'),
+          touchIcons,
+          title: document.title,
+          appleSplashScreens: splashScreens,
+        };
+      })()`);
+            const checks = [];
+            // apple-mobile-web-app-capable
+            checks.push({
+                pass: result.capable === 'yes',
+                label: 'apple-mobile-web-app-capable',
+                detail: result.capable === 'yes'
+                    ? 'Set to "yes" — app will run in standalone mode.'
+                    : 'Not set or not "yes". The app will open in Safari, not standalone.',
+            });
+            // apple-touch-icon
+            const has180 = result.touchIcons.some(i => i.sizes === '180x180');
+            checks.push({
+                pass: result.touchIcons.length > 0,
+                label: 'apple-touch-icon',
+                detail: result.touchIcons.length > 0
+                    ? `${result.touchIcons.length} icon(s): ${result.touchIcons.map(i => i.sizes).join(', ')}` +
+                        (has180 ? '' : '. ⚠ Missing 180x180 (recommended for iPhone).')
+                    : 'No apple-touch-icon found. iOS will use a screenshot as the icon.',
+            });
+            // theme-color
+            checks.push({
+                pass: result.themeColor !== null,
+                label: 'theme-color',
+                detail: result.themeColor !== null
+                    ? `Set to "${result.themeColor}".`
+                    : 'Not set. Safari 15+ uses theme-color for the tab bar tint.',
+            });
+            // status bar style
+            checks.push({
+                pass: result.statusBarStyle !== null,
+                label: 'apple-mobile-web-app-status-bar-style',
+                detail: result.statusBarStyle !== null
+                    ? `Set to "${result.statusBarStyle}".`
+                    : 'Not set. Defaults to "default" (black text on white). Consider "black-translucent" for full-screen feel.',
+            });
+            // manifest
+            checks.push({
+                pass: result.manifestHref !== null,
+                label: 'Web App Manifest',
+                detail: result.manifestHref !== null
+                    ? `Found: ${result.manifestHref}`
+                    : 'No <link rel="manifest"> found. Required for PWA install prompts.',
+            });
+            // splash screens
+            checks.push({
+                pass: result.appleSplashScreens > 0,
+                label: 'apple-touch-startup-image',
+                detail: result.appleSplashScreens > 0
+                    ? `${result.appleSplashScreens} splash screen(s) defined.`
+                    : 'No splash screens. Users will see a white screen while the app loads.',
+            });
+            const passed = checks.filter(c => c.pass).length;
+            const lines = [
+                `iOS Web App Readiness: ${passed}/${checks.length} checks passed`,
+                '',
+            ];
+            for (const c of checks) {
+                lines.push(`${c.pass ? '✅' : '❌'} ${c.label}`);
+                lines.push(`   ${c.detail}`);
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        },
+    }),
+];
+//# sourceMappingURL=ios-validation.js.map

package/build/src/tools/ios-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-validation.js","sourceRoot":"","sources":["../../../src/tools/ios-validation.ts"],"names":[],"mappings":"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"}

package/build/src/tools/webkit-compat.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WebKit CSS compatibility checker.
+ *
+ * Runs inside a live Safari WebDriver session. Extracts CSS from the page
+ * using structured DOM APIs (rule.style iteration — no regex, no false
+ * positives on custom properties), then runs CSS.supports() in the actual
+ * browser to report what is genuinely broken right now.
+ */
+export declare const tools: import("./types.js").ToolDef<import("zod").ZodRawShape>[];
+//# sourceMappingURL=webkit-compat.d.ts.map

package/build/src/tools/webkit-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webkit-compat.d.ts","sourceRoot":"","sources":["../../../src/tools/webkit-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,eAAO,MAAM,KAAK,2DAkKjB,CAAC"}

package/build/src/tools/webkit-compat.js

@@ -0,0 +1,165 @@
+/**
+ * WebKit CSS compatibility checker.
+ *
+ * Runs inside a live Safari WebDriver session. Extracts CSS from the page
+ * using structured DOM APIs (rule.style iteration — no regex, no false
+ * positives on custom properties), then runs CSS.supports() in the actual
+ * browser to report what is genuinely broken right now.
+ */
+import { defineTool } from './types.js';
+/**
+ * Behavioral quirks that CSS.supports() cannot detect — the property IS
+ * "supported", it just renders incorrectly. Keep this list small, precise,
+ * and each entry must be a confirmed Safari rendering bug.
+ */
+const BEHAVIORAL_QUIRKS = [
+    {
+        property: 'position',
+        matchValue: 'sticky',
+        message: 'position:sticky silently fails inside an overflow:hidden or overflow:auto ' +
+            'ancestor in Safari. Use overflow:clip on the ancestor instead.',
+    },
+];
+export const tools = [
+    defineTool({
+        name: 'check_webkit_compatibility',
+        description: 'Check CSS on the current page against the live Safari session. ' +
+            'Extracts every CSS property via structured DOM APIs, runs CSS.supports() ' +
+            'in the actual browser, and reports what is broken right now — unsupported ' +
+            'properties, missing -webkit- prefixes, and known Safari rendering quirks.',
+        slimDescription: 'Check CSS against live Safari via CSS.supports().',
+        schema: {},
+        handler: async (_params, driver) => {
+            // -----------------------------------------------------------------
+            // Step 1: Extract structured CSS from the page + run CSS.supports()
+            // in one round-trip. Uses rule.style iteration for canonical property
+            // names — custom properties (--*) are excluded automatically.
+            // -----------------------------------------------------------------
+            const results = await driver.runScript(`(() => {
+        // Collect unique property:value pairs from all accessible stylesheets
+        const seen = new Map();
+
+        function collectFromStyle(style) {
+          for (const prop of style) {
+            if (prop.startsWith('--')) continue;
+            if (seen.has(prop)) continue;
+            seen.set(prop, style.getPropertyValue(prop).trim());
+          }
+        }
+
+        function processRules(rules) {
+          for (const rule of rules) {
+            // Skip @font-face — its descriptors (src, font-display, unicode-range)
+            // are not CSS properties and CSS.supports() always returns false for them
+            if (rule.constructor?.name === 'CSSFontFaceRule') continue;
+            if (rule.style) collectFromStyle(rule.style);
+            if (rule.cssRules) {
+              try { processRules(rule.cssRules); } catch {}
+            }
+          }
+        }
+
+        for (const sheet of document.styleSheets) {
+          try { processRules(sheet.cssRules); } catch {}
+        }
+
+        // Inline styles
+        for (const el of document.querySelectorAll('[style]')) {
+          collectFromStyle(el.style);
+        }
+
+        const totalProperties = seen.size;
+        const unsupported = [];
+        const needsPrefix = [];
+
+        for (const [prop, value] of seen) {
+          let supported = false;
+          try { supported = CSS.supports(prop, value); } catch {}
+
+          if (!supported) {
+            // Try again with a generic value — the extracted value might be
+            // a computed/resolved form CSS.supports doesn't accept
+            try { supported = CSS.supports(prop, 'initial'); } catch {}
+          }
+
+          if (supported) continue;
+
+          // Not supported unprefixed — check if -webkit- variant works
+          const webkitProp = '-webkit-' + prop;
+          let webkitSupported = false;
+          try { webkitSupported = CSS.supports(webkitProp, value); } catch {}
+          if (!webkitSupported) {
+            try { webkitSupported = CSS.supports(webkitProp, 'initial'); } catch {}
+          }
+
+          if (webkitSupported) {
+            needsPrefix.push({ property: prop, value });
+          } else {
+            unsupported.push({ property: prop, value });
+          }
+        }
+
+        // Collect a subset of computed properties for behavioral quirk checks
+        const body = document.body;
+        const computedProperties = {};
+        if (body) {
+          const quirkProps = ${JSON.stringify(BEHAVIORAL_QUIRKS.map(q => q.property))};
+          for (const prop of quirkProps) {
+            if (seen.has(prop)) {
+              computedProperties[prop] = seen.get(prop);
+            }
+          }
+        }
+
+        return { totalProperties, unsupported, needsPrefix, computedProperties };
+      })()`);
+            // -----------------------------------------------------------------
+            // Step 2: Check behavioral quirks
+            // -----------------------------------------------------------------
+            const quirks = [];
+            for (const quirk of BEHAVIORAL_QUIRKS) {
+                const value = results.computedProperties[quirk.property];
+                if (value === undefined)
+                    continue;
+                if (quirk.matchValue && !value.includes(quirk.matchValue))
+                    continue;
+                quirks.push(quirk.message);
+            }
+            // -----------------------------------------------------------------
+            // Step 3: Format output
+            // -----------------------------------------------------------------
+            const total = results.unsupported.length + results.needsPrefix.length + quirks.length;
+            const lines = [];
+            if (total === 0) {
+                lines.push(`✅ No issues found. ${results.totalProperties} CSS properties checked via CSS.supports() in this Safari session.`);
+            }
+            else {
+                lines.push(`Found ${total} issue(s) — ${results.totalProperties} properties checked via CSS.supports() in this Safari session.`);
+                lines.push('');
+                if (results.unsupported.length > 0) {
+                    lines.push(`❌ Unsupported in this Safari (${results.unsupported.length}):`);
+                    for (const { property, value } of results.unsupported) {
+                        const preview = value.length > 60 ? value.slice(0, 57) + '...' : value;
+                        lines.push(`  ${property}: ${preview}`);
+                    }
+                    lines.push('');
+                }
+                if (results.needsPrefix.length > 0) {
+                    lines.push(`⚠ Needs -webkit- prefix (${results.needsPrefix.length}):`);
+                    for (const { property } of results.needsPrefix) {
+                        lines.push(`  ${property} → use -webkit-${property} alongside it`);
+                    }
+                    lines.push('');
+                }
+                if (quirks.length > 0) {
+                    lines.push(`ℹ Known Safari rendering quirks (${quirks.length}):`);
+                    for (const msg of quirks) {
+                        lines.push(`  ${msg}`);
+                    }
+                }
+            }
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        },
+    }),
+];
+//# sourceMappingURL=webkit-compat.js.map

package/build/src/tools/webkit-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webkit-compat.js","sourceRoot":"","sources":["../../../src/tools/webkit-compat.ts"],"names":[],"mappings":"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"}

package/build/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.7.0";
+export declare const VERSION = "1.8.1";
 //# sourceMappingURL=version.d.ts.map

package/build/src/version.js

@@ -1,4 +1,4 @@
 // x-release-please-start-version
-export const VERSION = '1.7.0';
+export const VERSION = '1.8.1';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "safari-devtools-mcp",
   "mcpName": "io.github.HayoDev/safari-devtools-mcp",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "Safari DevTools MCP — real browser debugging with network interception, DOM inspection, cookie/storage management, and CSS analysis for AI agents on macOS",
   "type": "module",
   "main": "build/src/index.js",

package/skills/safari-specific-debugging/SKILL.md

@@ -7,18 +7,23 @@ or when debugging WebKit-specific behavior.
 
 ### CSS issues
 
-Safari lags behind on some CSS features and requires `-webkit-` prefixes
-for others. Debug with:
+Start by running `check_webkit_compatibility` — it checks every CSS property
+on the page against the live Safari session via `CSS.supports()` and reports
+what is actually broken (unsupported properties, missing `-webkit-` prefixes):
+
+```
+check_webkit_compatibility
+```
+
+For specific elements, inspect computed styles directly:
 
 ```
 get_computed_style uid="<element-uid>" properties=["display", "gap", "aspect-ratio", "container-type", "backdrop-filter"]
 ```
 
-**Known Safari CSS quirks:**
+**Common Safari CSS gotchas:**
 
-- `gap` in flexbox: Supported since Safari 14.1, but older versions fail silently.
-- `aspect-ratio`: Works, but may not apply in some flex/grid contexts.
-- `-webkit-backdrop-filter`: Still requires prefix in some versions.
+- `-webkit-backdrop-filter`: Still requires prefix in Safari <18.
 - `100vh` on iOS Safari includes the address bar — use `100dvh` instead.
 - `position: sticky` inside `overflow: auto` containers often breaks.
 - `:has()` selector: Safari was first to ship it, but edge cases may differ.
@@ -115,7 +120,13 @@ see what the a11y tree reports, then `take_screenshot` for visual comparison.
    evaluate_script function="() => { /* feature detection code */ }"
    ```
 
-6. Check CSS rendering:
+6. Check CSS compatibility across the page:
+
+   ```
+   check_webkit_compatibility
+   ```
+
+7. Inspect a specific element's styles:
    ```
    get_computed_style uid="<element-uid>"
    ```