@wa008/ui-audit-mcp 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wa008
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# UI Audit MCP
+
+An MCP server for iOS app UI evaluation and testing.
+
+## Features
+- **Device Control**: Launch apps, take screenshots, tap, and swipe on iOS Simulators.
+- **UI Evaluation**: Structured checklists for quality and style consistency.
+
+## Prerequisites
+- **Node.js 18+**
+- **Xcode CLI Tools**: `xcode-select --install` (for `xcrun simctl`)
+- **idb**: Required for tap/swipe.
+  ```bash
+  brew install idb-companion
+  pip3 install fb-idb
+  ```
+
+## Quick Install (via npx)
+Add this to your MCP client config (e.g., `claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "ui-audit": {
+      "command": "npx",
+      "args": ["-y", "@wa007/ui-audit-mcp"]
+    }
+  }
+}
+```
+*(Note: Requires the package to be published to NPM. For local development, use the Setup steps below.)*
+
+## Manual Setup
+```bash
+git clone https://github.com/wa008/ui-audit-mcp.git
+cd ui-audit-mcp
+npm install
+```
+
+### Manual Config
+```json
+{
+  "mcpServers": {
+    "ui-audit": {
+      "command": "node",
+      "args": ["/absolute/path/to/ui-audit-mcp/dist/src/index.js"]
+    }
+  }
+}
+```
+
+## Tools
+| Tool | Purpose |
+|---|---|
+| `launch_app` | Launch app by Bundle ID |
+| `list_apps` | keys to find Bundle IDs |
+| `take_screenshot` | Capture screen & metadata |
+| `tap` / `swipe` | Interact with UI (ratio coordinates 0-1) |
+| `get_checklist` | Start evaluation session (screen/style) |
+| `submit_evaluation` | Submit scores (1-5) & get pass/fail result |
+| `evaluate_style_consistency` | Compare multiple screens |
+| `get_evaluation_log` | Review past results |
+
+## Typical Workflow
+1. `list_apps(all: false)` → Find Bundle ID
+2. `launch_app("com.example.app")`
+3. `take_screenshot()`
+4. `get_checklist(type: "screen")` → Get session ID
+5. Agent analyzes UI → `submit_evaluation(sessionId, scores)`
+
+## Data
+Logs: `~/.ui-audit-mcp/logs/`
+Screenshots: `~/.ui-audit-mcp/screenshots/`
+
+## License
+MIT

package/dist/device/adapter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Device adapter using idb + xcrun simctl.
+ *
+ * Dependencies:
+ *   - xcrun simctl (ships with Xcode CLI tools) → launch app, screenshot
+ *   - idb (Facebook's iOS Development Bridge)    → tap, swipe
+ *
+ * Install idb:
+ *   brew install idb-companion
+ *   pip3 install fb-idb
+ *
+ * Coordinates use the iOS points system. The adapter accepts ratio
+ * coordinates (0-1) and converts them using the screen dimensions
+ * obtained from the screenshot.
+ */
+/** Check that required CLI tools are available. */
+export declare function preflight(): Promise<{
+    ok: boolean;
+    missing: string[];
+}>;
+/** Launch an app by bundle ID on the booted simulator. */
+export declare function launchApp(appId: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/** Take a screenshot and return base64 PNG + dimensions. */
+export declare function takeScreenshot(): Promise<{
+    imageBase64: string;
+    width: number;
+    height: number;
+    filePath: string;
+}>;
+/** Tap at ratio coordinates (0-1). Converts to points using screen size. */
+export declare function tap(ratioX: number, ratioY: number): Promise<{
+    success: boolean;
+    pointX: number;
+    pointY: number;
+    error?: string;
+}>;
+/** Swipe using ratio coordinates (0-1). */
+export declare function swipe(startX: number, startY: number, endX: number, endY: number): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/device/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/device/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA+BH,mDAAmD;AACnD,wBAAsB,SAAS,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAa7E;AAID,0DAA0D;AAC1D,wBAAsB,SAAS,CAC3B,KAAK,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ/C;AAED,4DAA4D;AAC5D,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC,CAcD;AAED,4EAA4E;AAC5E,wBAAsB,GAAG,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAe/E;AAED,2CAA2C;AAC3C,wBAAsB,KAAK,CACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB/C"}

package/dist/device/adapter.js

@@ -0,0 +1,137 @@
+/**
+ * Device adapter using idb + xcrun simctl.
+ *
+ * Dependencies:
+ *   - xcrun simctl (ships with Xcode CLI tools) → launch app, screenshot
+ *   - idb (Facebook's iOS Development Bridge)    → tap, swipe
+ *
+ * Install idb:
+ *   brew install idb-companion
+ *   pip3 install fb-idb
+ *
+ * Coordinates use the iOS points system. The adapter accepts ratio
+ * coordinates (0-1) and converts them using the screen dimensions
+ * obtained from the screenshot.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { randomUUID } from "node:crypto";
+const execFileAsync = promisify(execFile);
+const SCREENSHOT_DIR = path.join(os.homedir(), ".ui-critic-mcp", "screenshots");
+function ensureDir(dir) {
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+/** Read PNG width and height from the IHDR chunk (bytes 16-23). */
+function readPngDimensions(filePath) {
+    const buf = Buffer.alloc(24);
+    const fd = fs.openSync(filePath, "r");
+    fs.readSync(fd, buf, 0, 24, 0);
+    fs.closeSync(fd);
+    return { width: buf.readUInt32BE(16), height: buf.readUInt32BE(20) };
+}
+const IDB_INSTALL_HINT = "idb is required for tap/swipe. Install it with:\n" +
+    "  brew install idb-companion\n" +
+    "  pip3 install fb-idb\n" +
+    "See https://fbidb.io for details.";
+/** Check that required CLI tools are available. */
+export async function preflight() {
+    const missing = [];
+    try {
+        await execFileAsync("xcrun", ["simctl", "list", "devices", "booted"]);
+    }
+    catch {
+        missing.push("xcrun simctl (install Xcode Command Line Tools)");
+    }
+    try {
+        await execFileAsync("idb", ["--help"]);
+    }
+    catch {
+        missing.push(`idb (${IDB_INSTALL_HINT})`);
+    }
+    return { ok: missing.length === 0, missing };
+}
+// ─── Public API ──────────────────────────────────────────
+/** Launch an app by bundle ID on the booted simulator. */
+export async function launchApp(appId) {
+    try {
+        await execFileAsync("xcrun", ["simctl", "launch", "booted", appId]);
+        return { success: true };
+    }
+    catch (err) {
+        const e = err;
+        return { success: false, error: e.stderr ?? e.message ?? String(err) };
+    }
+}
+/** Take a screenshot and return base64 PNG + dimensions. */
+export async function takeScreenshot() {
+    ensureDir(SCREENSHOT_DIR);
+    const filePath = path.join(SCREENSHOT_DIR, `${randomUUID()}.png`);
+    try {
+        await execFileAsync("xcrun", ["simctl", "io", "booted", "screenshot", filePath]);
+    }
+    catch (err) {
+        const e = err;
+        throw new Error(`Screenshot failed: ${e.stderr ?? e.message}`);
+    }
+    const { width, height } = readPngDimensions(filePath);
+    const imageBase64 = fs.readFileSync(filePath).toString("base64");
+    return { imageBase64, width, height, filePath };
+}
+/** Tap at ratio coordinates (0-1). Converts to points using screen size. */
+export async function tap(ratioX, ratioY) {
+    const { width, height } = await getScreenSize();
+    const pointX = Math.round(ratioX * width);
+    const pointY = Math.round(ratioY * height);
+    try {
+        await execFileAsync("idb", ["ui", "tap", String(pointX), String(pointY)]);
+        return { success: true, pointX, pointY };
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT") {
+            return { success: false, pointX, pointY, error: IDB_INSTALL_HINT };
+        }
+        return { success: false, pointX, pointY, error: e.stderr ?? e.message ?? String(err) };
+    }
+}
+/** Swipe using ratio coordinates (0-1). */
+export async function swipe(startX, startY, endX, endY) {
+    const { width, height } = await getScreenSize();
+    const x1 = Math.round(startX * width);
+    const y1 = Math.round(startY * height);
+    const x2 = Math.round(endX * width);
+    const y2 = Math.round(endY * height);
+    try {
+        await execFileAsync("idb", [
+            "ui", "swipe", String(x1), String(y1), String(x2), String(y2),
+        ]);
+        return { success: true };
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT") {
+            return { success: false, error: IDB_INSTALL_HINT };
+        }
+        return { success: false, error: e.stderr ?? e.message ?? String(err) };
+    }
+}
+// ─── Internal ────────────────────────────────────────────
+let cachedScreenSize = null;
+/** Get screen size by taking a quick screenshot and reading its dimensions. */
+async function getScreenSize() {
+    if (cachedScreenSize)
+        return cachedScreenSize;
+    const result = await takeScreenshot();
+    cachedScreenSize = { width: result.width, height: result.height };
+    // Clean up the temp screenshot — it was only needed for dimensions
+    try {
+        fs.unlinkSync(result.filePath);
+    }
+    catch { /* ignore */ }
+    return cachedScreenSize;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/device/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/device/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;AAEhF,SAAS,SAAS,CAAC,GAAW;IAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,mEAAmE;AACnE,SAAS,iBAAiB,CAAC,QAAgB;IACvC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/B,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,gBAAgB,GAClB,mDAAmD;IACnD,gCAAgC;IAChC,yBAAyB;IACzB,mCAAmC,CAAC;AAExC,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,SAAS;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC;QACD,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,CAAC;QACD,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,IAAI,CAAC,QAAQ,gBAAgB,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,4DAA4D;AAE5D,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,KAAa;IAEb,IAAI,CAAC;QACD,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,GAA4C,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3E,CAAC;AACL,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,cAAc;IAMhC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,UAAU,EAAE,MAAM,CAAC,CAAC;IAElE,IAAI,CAAC;QACD,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,GAA4C,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpD,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,GAAG,CACrB,MAAc,EACd,MAAc;IAEd,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAE3C,IAAI,CAAC;QACD,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,GAA2D,CAAC;QACtE,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QACvE,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3F,CAAC;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,KAAK,CACvB,MAAc,EACd,MAAc,EACd,IAAY,EACZ,IAAY;IAEZ,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,EAAE,CAAC;IAChD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IAErC,IAAI,CAAC;QACD,MAAM,aAAa,CAAC,KAAK,EAAE;YACvB,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;SAChE,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,GAA2D,CAAC;QACtE,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAC3E,CAAC;AACL,CAAC;AAED,4DAA4D;AAE5D,IAAI,gBAAgB,GAA6C,IAAI,CAAC;AAEtE,+EAA+E;AAC/E,KAAK,UAAU,aAAa;IACxB,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;IACtC,gBAAgB,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAClE,mEAAmE;IACnE,IAAI,CAAC;QAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC9D,OAAO,gBAAgB,CAAC;AAC5B,CAAC"}

package/dist/evaluation/checklist.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Evaluation checklist definitions.
+ *
+ * Screen evaluation: 4 items (overlap, layout, info clarity, ambiguity)
+ * Style consistency: 3 items (color, component, typography)
+ */
+import { ChecklistItem } from "../types.js";
+/** Single-screen UI quality checklist */
+export declare const SCREEN_CHECKLIST: ChecklistItem[];
+/** Multi-screen style-consistency checklist */
+export declare const STYLE_CHECKLIST: ChecklistItem[];
+/** Default passing score for each checklist item (on a 1-5 scale) */
+export declare const DEFAULT_PASSING_SCORE = 3;
+//# sourceMappingURL=checklist.d.ts.map

package/dist/evaluation/checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist.d.ts","sourceRoot":"","sources":["../../src/evaluation/checklist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,EAAE,aAAa,EAiC3C,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,eAAe,EAAE,aAAa,EAyB1C,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,IAAI,CAAC"}

package/dist/evaluation/checklist.js

@@ -0,0 +1,57 @@
+/**
+ * Evaluation checklist definitions.
+ *
+ * Screen evaluation: 4 items (overlap, layout, info clarity, ambiguity)
+ * Style consistency: 3 items (color, component, typography)
+ */
+/** Single-screen UI quality checklist */
+export const SCREEN_CHECKLIST = [
+    {
+        id: "overlap",
+        name: "Element Overlap Detection",
+        description: "Check whether any UI elements (text, buttons, images, icons) overlap or obscure each other on the current screen.",
+        scoringGuide: "1 = severe overlap affecting usability, 2 = noticeable overlap, 3 = minor overlap, 4 = almost no overlap, 5 = no overlap at all",
+    },
+    {
+        id: "layout",
+        name: "Layout & Alignment",
+        description: "Check whether button sizes are reasonable, elements are properly aligned, spacing is consistent, and the overall layout is harmonious.",
+        scoringGuide: "1 = chaotic layout, 2 = obvious layout issues, 3 = acceptable with minor flaws, 4 = good layout, 5 = polished layout",
+    },
+    {
+        id: "info_clarity",
+        name: "Information Clarity",
+        description: "Check whether the user can quickly identify key information on this screen, whether the information hierarchy is clear, and whether the primary call-to-action (CTA) is prominent.",
+        scoringGuide: "1 = key information is impossible to find, 2 = confusing, 3 = readable but not ideal, 4 = clear, 5 = excellent hierarchy",
+    },
+    {
+        id: "ambiguity",
+        name: "Expression Ambiguity",
+        description: "Check whether any copy, icons, or button labels are ambiguous or misleading, and whether the intended action is clearly communicated to the user.",
+        scoringGuide: "1 = severely ambiguous / misleading, 2 = multiple ambiguities, 3 = minor ambiguity, 4 = clear, 5 = precise and unambiguous",
+    },
+];
+/** Multi-screen style-consistency checklist */
+export const STYLE_CHECKLIST = [
+    {
+        id: "color_consistency",
+        name: "Color Scheme Consistency",
+        description: "Compare all provided screenshots and check whether the primary colors, accent colors, and background colors are consistent across screens.",
+        scoringGuide: "1 = completely different styles, 2 = noticeable inconsistencies, 3 = mostly consistent, 4 = well unified, 5 = perfectly unified",
+    },
+    {
+        id: "component_consistency",
+        name: "Component Style Consistency",
+        description: "Compare buttons, navigation bars, cards, and other reusable components across all screenshots to verify they share the same visual style (corner radius, shadow, spacing, etc.).",
+        scoringGuide: "1 = every screen looks different, 2 = noticeable differences, 3 = mostly consistent, 4 = well unified, 5 = strict design system",
+    },
+    {
+        id: "typography_consistency",
+        name: "Typography Consistency",
+        description: "Compare heading sizes, body text sizes, font weights, and line spacing across all screenshots to verify consistency.",
+        scoringGuide: "1 = chaotic typography, 2 = noticeable differences, 3 = mostly consistent, 4 = well unified, 5 = strictly unified",
+    },
+];
+/** Default passing score for each checklist item (on a 1-5 scale) */
+export const DEFAULT_PASSING_SCORE = 3;
+//# sourceMappingURL=checklist.js.map

package/dist/evaluation/checklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist.js","sourceRoot":"","sources":["../../src/evaluation/checklist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC7C;QACI,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACP,mHAAmH;QACvH,YAAY,EACR,iIAAiI;KACxI;IACD;QACI,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACP,wIAAwI;QAC5I,YAAY,EACR,sHAAsH;KAC7H;IACD;QACI,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACP,oLAAoL;QACxL,YAAY,EACR,0HAA0H;KACjI;IACD;QACI,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACP,mJAAmJ;QACvJ,YAAY,EACR,4HAA4H;KACnI;CACJ,CAAC;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC5C;QACI,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACP,4IAA4I;QAChJ,YAAY,EACR,iIAAiI;KACxI;IACD;QACI,EAAE,EAAE,uBAAuB;QAC3B,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACP,kLAAkL;QACtL,YAAY,EACR,iIAAiI;KACxI;IACD;QACI,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACP,sHAAsH;QAC1H,YAAY,EACR,mHAAmH;KAC1H;CACJ,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC"}

package/dist/evaluation/scorer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Scoring logic — determines pass / fail for each checklist item
+ * and computes the overall evaluation outcome.
+ */
+import { ChecklistItem, EvaluationOutcome, EvaluationType, ScoreEntry } from "../types.js";
+export declare function evaluateScores(sessionId: string, type: EvaluationType, screenName: string, checklist: ChecklistItem[], scores: ScoreEntry[], passingScore: number, attemptNumber: number): EvaluationOutcome;
+//# sourceMappingURL=scorer.d.ts.map

package/dist/evaluation/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../src/evaluation/scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,aAAa,EACb,iBAAiB,EAEjB,cAAc,EACd,UAAU,EACb,MAAM,aAAa,CAAC;AAErB,wBAAgB,cAAc,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,EAAE,EAC1B,MAAM,EAAE,UAAU,EAAE,EACpB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACtB,iBAAiB,CAgCnB"}

package/dist/evaluation/scorer.js

@@ -0,0 +1,35 @@
+/**
+ * Scoring logic — determines pass / fail for each checklist item
+ * and computes the overall evaluation outcome.
+ */
+export function evaluateScores(sessionId, type, screenName, checklist, scores, passingScore, attemptNumber) {
+    const results = checklist.map((item) => {
+        const entry = scores.find((s) => s.id === item.id);
+        const score = entry?.score ?? 0;
+        const passed = score >= passingScore;
+        return {
+            id: item.id,
+            score,
+            passed,
+            reason: entry?.reason,
+            suggestion: entry?.suggestion,
+        };
+    });
+    const failedItems = results.filter((r) => !r.passed).map((r) => r.id);
+    const totalScore = results.reduce((sum, r) => sum + r.score, 0);
+    const averageScore = results.length > 0
+        ? parseFloat((totalScore / results.length).toFixed(2))
+        : 0;
+    return {
+        sessionId,
+        type,
+        screenName,
+        overallPassed: failedItems.length === 0,
+        averageScore,
+        results,
+        failedItems,
+        timestamp: new Date().toISOString(),
+        attemptNumber,
+    };
+}
+//# sourceMappingURL=scorer.js.map

package/dist/evaluation/scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.js","sourceRoot":"","sources":["../../src/evaluation/scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,UAAU,cAAc,CAC1B,SAAiB,EACjB,IAAoB,EACpB,UAAkB,EAClB,SAA0B,EAC1B,MAAoB,EACpB,YAAoB,EACpB,aAAqB;IAErB,MAAM,OAAO,GAAuB,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,IAAI,YAAY,CAAC;QACrC,OAAO;YACH,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK;YACL,MAAM;YACN,MAAM,EAAE,KAAK,EAAE,MAAM;YACrB,UAAU,EAAE,KAAK,EAAE,UAAU;SAChC,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,YAAY,GACd,OAAO,CAAC,MAAM,GAAG,CAAC;QACd,CAAC,CAAC,UAAU,CAAC,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC,CAAC;IAEZ,OAAO;QACH,SAAS;QACT,IAAI;QACJ,UAAU;QACV,aAAa,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;QACvC,YAAY;QACZ,OAAO;QACP,WAAW;QACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,aAAa;KAChB,CAAC;AACN,CAAC"}

package/dist/examples/agent-demo.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-demo.d.ts.map

package/dist/examples/agent-demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-demo.d.ts","sourceRoot":"","sources":["../../examples/agent-demo.ts"],"names":[],"mappings":""}

package/dist/examples/agent-demo.js

@@ -0,0 +1,79 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import * as path from "path";
+// Connect to the local MCP server
+async function run() {
+    console.log("Starting MCP Client...");
+    const transport = new StdioClientTransport({
+        command: "node",
+        args: [path.join(process.cwd(), "dist/src/index.js")],
+    });
+    const client = new Client({
+        name: "test-agent",
+        version: "1.0.0",
+    }, {
+        capabilities: {},
+    });
+    try {
+        await client.connect(transport);
+        console.log("Connected to MCP server.");
+        // 1. Launch App
+        console.log("Launching Preferences app...");
+        await client.callTool({
+            name: "launch_app",
+            arguments: { appId: "com.apple.Preferences" },
+        });
+        // 2. Take Screenshot
+        console.log("Taking screenshot...");
+        const screenshotResult = await client.callTool({
+            name: "take_screenshot",
+            arguments: {},
+        });
+        if (screenshotResult.imageBase64) {
+            console.log(`Screenshot captured (${screenshotResult.width}x${screenshotResult.height})`);
+        }
+        // 3. Get Checklist (Screen)
+        console.log("Getting checklist for 'SettingsScreen'...");
+        const checklistResult = await client.callTool({
+            name: "get_checklist",
+            arguments: { type: "screen", screenName: "SettingsScreen" },
+        });
+        const checklistData = JSON.parse(checklistResult.content[0].text);
+        const sessionId = checklistData.sessionId;
+        const items = checklistData.checklist;
+        console.log(`Session ID: ${sessionId}`);
+        console.log(`Checklist items: ${items.map((i) => i.id).join(", ")}`);
+        // 4. Submit Evaluation (Simulate passing)
+        console.log("Submitting passing evaluation...");
+        const scores = items.map((item) => ({
+            id: item.id,
+            score: 5,
+        }));
+        const evalResult = await client.callTool({
+            name: "submit_evaluation",
+            arguments: {
+                sessionId: sessionId,
+                scores: scores,
+            },
+        });
+        console.log("Evaluation result:", JSON.parse(evalResult.content[0].text));
+        // 5. Get Logs
+        console.log("Fetching logs...");
+        const logResult = await client.callTool({
+            name: "get_evaluation_log",
+            arguments: { limit: 1 },
+        });
+        console.log("Logs retrieved.");
+    }
+    catch (error) {
+        console.error("Error running test agent:", error);
+    }
+    finally {
+        // transport.close() is not exposed directly on StdioClientTransport in some versions,
+        // but client.close() should handle it?
+        // Actually, just exit process.
+        process.exit(0);
+    }
+}
+run();
+//# sourceMappingURL=agent-demo.js.map

package/dist/examples/agent-demo.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * UI Critic MCP Server
+ *
+ * An MCP server for iOS app UI evaluation and testing.
+ * Uses idb + xcrun simctl for device operations (launch, screenshot, tap, swipe)
+ * and provides a structured checklist-based evaluation workflow.
+ *
+ * Tools:
+ *   Device operations:
+ *     - launch_app          Launch an iOS app by bundle ID
+ *     - take_screenshot     Capture the current screen as base64 PNG
+ *     - tap                 Tap at ratio coordinates (0-1)
+ *     - swipe               Swipe between ratio coordinates (0-1)
+ *
+ *   Evaluation:
+ *     - get_checklist        Get the evaluation checklist and create a session
+ *     - submit_evaluation    Submit scores and get pass/fail result
+ *     - evaluate_style_consistency  Compare multiple screenshots for style consistency
+ *     - get_evaluation_log   Query past evaluation results
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/index.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * UI Critic MCP Server
+ *
+ * An MCP server for iOS app UI evaluation and testing.
+ * Uses idb + xcrun simctl for device operations (launch, screenshot, tap, swipe)
+ * and provides a structured checklist-based evaluation workflow.
+ *
+ * Tools:
+ *   Device operations:
+ *     - launch_app          Launch an iOS app by bundle ID
+ *     - take_screenshot     Capture the current screen as base64 PNG
+ *     - tap                 Tap at ratio coordinates (0-1)
+ *     - swipe               Swipe between ratio coordinates (0-1)
+ *
+ *   Evaluation:
+ *     - get_checklist        Get the evaluation checklist and create a session
+ *     - submit_evaluation    Submit scores and get pass/fail result
+ *     - evaluate_style_consistency  Compare multiple screenshots for style consistency
+ *     - get_evaluation_log   Query past evaluation results
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { launchAppSchema, launchApp } from "./tools/launch-app.js";
+import { takeScreenshotSchema, takeScreenshot } from "./tools/take-screenshot.js";
+import { tapSchema, tap } from "./tools/tap.js";
+import { swipeSchema, swipe } from "./tools/swipe.js";
+import { getChecklistSchema, getChecklist } from "./tools/get-checklist.js";
+import { submitEvaluationSchema, submitEvaluation } from "./tools/submit-evaluation.js";
+import { evaluateStyleSchema, evaluateStyleConsistency } from "./tools/evaluate-style.js";
+import { getEvaluationLogSchema, getEvaluationLog } from "./tools/get-log.js";
+const server = new McpServer({
+    name: "ui-critic-mcp",
+    version: "1.0.0",
+});
+// ─── Device operation tools ────────────────────────────────
+server.tool("launch_app", "Launch an iOS app on the simulator by its bundle ID.", launchAppSchema.shape, async (args) => launchApp(args));
+server.tool("take_screenshot", "Capture the current simulator screen as a base64 PNG image. " +
+    "Returns the image for visual inspection along with screen metadata.", takeScreenshotSchema.shape, async (args) => takeScreenshot(args));
+server.tool("tap", "Tap at a specific position on the screen. " +
+    "Uses ratio coordinates (0-1): x=0 is left edge, x=1 is right edge, y=0 is top, y=1 is bottom.", tapSchema.shape, async (args) => tap(args));
+server.tool("swipe", "Swipe from one point to another on the screen. " +
+    "Uses ratio coordinates (0-1) for both start and end positions.", swipeSchema.shape, async (args) => swipe(args));
+// ─── Evaluation tools ──────────────────────────────────────
+server.tool("get_checklist", "Get the UI evaluation checklist and create an evaluation session. " +
+    "Use type='screen' for single-screen quality evaluation (4 items: overlap, layout, info clarity, ambiguity). " +
+    "Use type='style' for multi-screen style consistency evaluation (3 items: color, component, typography).", getChecklistSchema.shape, async (args) => getChecklist(args));
+server.tool("submit_evaluation", "Submit scores for each checklist item. Determines pass/fail (passing score >= 3) " +
+    "and persists the result. Failed items include reasons and suggestions for improvement.", submitEvaluationSchema.shape, async (args) => submitEvaluation(args));
+server.tool("evaluate_style_consistency", "Compare multiple screenshots for visual style consistency. " +
+    "Provide at least 2 screenshots. Returns all images alongside a style consistency checklist. " +
+    "After analyzing, call submit_evaluation with the returned sessionId and your scores.", evaluateStyleSchema.shape, async (args) => evaluateStyleConsistency(args));
+server.tool("get_evaluation_log", "Query past evaluation results and summary statistics. " +
+    "Use to review improvement across attempts or generate a final report.", getEvaluationLogSchema.shape, async (args) => getEvaluationLog(args));
+import { preflight } from "./device/adapter.js";
+// ─── Start server ──────────────────────────────────────────
+async function main() {
+    // Check for required CLI tools (non-blocking — warn only)
+    const check = await preflight();
+    if (!check.ok) {
+        console.error("[ui-critic-mcp] ⚠️  Missing dependencies:");
+        for (const m of check.missing) {
+            console.error(`  - ${m}`);
+        }
+        console.error("[ui-critic-mcp] Some tools (tap, swipe) may not work.");
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[ui-critic-mcp] Server started on stdio transport.");
+}
+main().catch((err) => {
+    console.error("[ui-critic-mcp] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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