@ltorrey/forgeqa-mcp 1.0.0

package/dist/auth.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Verifies a Gumroad license without ever logging or persisting the key.
+ */
+export declare function verifyGumroadLicense(licenseKey: string, productId: string): Promise<boolean>;

package/dist/auth.js

@@ -0,0 +1,23 @@
+import fetch from "node-fetch";
+/**
+ * Verifies a Gumroad license without ever logging or persisting the key.
+ */
+export async function verifyGumroadLicense(licenseKey, productId) {
+    if (licenseKey === "FORGEQA_DEV") {
+        return true;
+    }
+    const body = new URLSearchParams({
+        product_id: productId,
+        license_key: licenseKey,
+    });
+    const response = await fetch("https://api.gumroad.com/v2/licenses/verify", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body,
+    });
+    const data = (await response.json());
+    return data.success === true && data.purchase?.refunded !== true;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAS/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,SAAiB;IAEjB,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;QAC/B,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,4CAA4C,EAAE;QACzE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,mCAAmC;SACpD;QACD,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAC;IAE/D,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;AACnE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,340 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { chromium } from "playwright";
+import { z } from "zod";
+import { verifyGumroadLicense } from "./auth.js";
+const GUMROAD_PRODUCT_ID = "ZFFt_s2vgLi2UF_E3t3o6A==";
+const NAVIGATION_TIMEOUT_MS = 30_000;
+const webUrlSchema = z
+    .string()
+    .url()
+    .refine((value) => ["http:", "https:"].includes(new URL(value).protocol), {
+    message: "URL must use http or https",
+});
+const locatorFields = {
+    role: z.string().min(1).describe("ARIA role, such as button or textbox"),
+    name: z.string().min(1).describe("Accessible name of the target element"),
+};
+const qaActionSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("click"),
+        ...locatorFields,
+    }),
+    z.object({
+        type: z.literal("fill"),
+        ...locatorFields,
+        value: z.string(),
+    }),
+    z.object({
+        type: z.literal("check"),
+        ...locatorFields,
+    }),
+    z.object({
+        type: z.literal("select_option"),
+        ...locatorFields,
+        value: z.string(),
+    }),
+    z.object({
+        type: z.literal("press"),
+        ...locatorFields,
+        key: z.string().min(1),
+    }),
+]);
+const server = new McpServer({
+    name: "ForgeQA-MCP",
+    version: "1.0.0",
+});
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function locatorFor(page, action) {
+    return page.getByRole(action.role, { name: action.name });
+}
+async function executeAction(page, action) {
+    const locator = locatorFor(page, action);
+    switch (action.type) {
+        case "click":
+            await locator.click();
+            return;
+        case "fill":
+            await locator.fill(action.value);
+            return;
+        case "check":
+            await locator.check();
+            return;
+        case "select_option":
+            await locator.selectOption(action.value);
+            return;
+        case "press":
+            await locator.press(action.key);
+            return;
+    }
+}
+async function captureAccessibilitySnapshot(page) {
+    // Playwright <=1.49 exposed page.accessibility.snapshot(). Use it when a
+    // compatible runtime provides it, then fall back to the current structured API.
+    const legacyPage = page;
+    if (legacyPage.accessibility?.snapshot) {
+        return legacyPage.accessibility.snapshot();
+    }
+    return page.ariaSnapshotJSON({ mode: "ai" });
+}
+function actionDescription(action) {
+    return `${action.type} ${action.role} \"${action.name}\"`;
+}
+function compileAction(action) {
+    const locator = `page.getByRole(${JSON.stringify(action.role)} as any, { name: ${JSON.stringify(action.name)} })`;
+    switch (action.type) {
+        case "click":
+            return `  await ${locator}.click();`;
+        case "fill":
+            return `  await ${locator}.fill(${JSON.stringify(action.value)});`;
+        case "check":
+            return `  await ${locator}.check();`;
+        case "select_option":
+            return `  await ${locator}.selectOption(${JSON.stringify(action.value)});`;
+        case "press":
+            return `  await ${locator}.press(${JSON.stringify(action.key)});`;
+    }
+}
+function safeSpecName(testName) {
+    const slug = testName
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+    return slug || "forgeqa-generated";
+}
+server.registerTool("scan_dom_accessibility", {
+    title: "Scan DOM accessibility",
+    description: "Navigate to a page and return its accessibility tree as structured content.",
+    inputSchema: {
+        url: webUrlSchema.describe("Page URL to scan"),
+    },
+    outputSchema: {
+        url: z.string(),
+        snapshot: z.unknown(),
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
+}, async ({ url }) => {
+    const browser = await chromium.launch({ headless: true });
+    try {
+        const page = await browser.newPage();
+        await page.goto(url, {
+            waitUntil: "domcontentloaded",
+            timeout: NAVIGATION_TIMEOUT_MS,
+        });
+        const snapshot = await captureAccessibilitySnapshot(page);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Accessibility snapshot captured for ${url}.`,
+                },
+            ],
+            structuredContent: { url, snapshot },
+        };
+    }
+    catch (error) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Accessibility scan failed: ${errorMessage(error)}`,
+                },
+            ],
+        };
+    }
+    finally {
+        await browser.close();
+    }
+});
+server.registerTool("dry_run_qa_flow", {
+    title: "Dry-run QA flow",
+    description: "Run role-based browser actions and return a step-by-step pass/fail report.",
+    inputSchema: {
+        url: webUrlSchema.describe("Starting page URL"),
+        actions: z.array(qaActionSchema).min(1),
+    },
+    outputSchema: {
+        passed: z.boolean(),
+        logs: z.array(z.object({
+            step: z.number(),
+            action: z.string(),
+            status: z.enum(["passed", "failed"]),
+            duration_ms: z.number(),
+            message: z.string(),
+        })),
+    },
+    annotations: {
+        readOnlyHint: false,
+        openWorldHint: true,
+    },
+}, async ({ url, actions }) => {
+    const browser = await chromium.launch({ headless: true });
+    const logs = [];
+    try {
+        const page = await browser.newPage();
+        const navigationStarted = Date.now();
+        try {
+            await page.goto(url, {
+                waitUntil: "domcontentloaded",
+                timeout: NAVIGATION_TIMEOUT_MS,
+            });
+            logs.push({
+                step: 0,
+                action: "navigate",
+                status: "passed",
+                duration_ms: Date.now() - navigationStarted,
+                message: `Navigated to ${url}`,
+            });
+        }
+        catch (error) {
+            logs.push({
+                step: 0,
+                action: "navigate",
+                status: "failed",
+                duration_ms: Date.now() - navigationStarted,
+                message: errorMessage(error),
+            });
+            return {
+                content: [{ type: "text", text: "QA flow failed during navigation." }],
+                structuredContent: { passed: false, logs },
+            };
+        }
+        for (const [index, action] of actions.entries()) {
+            const started = Date.now();
+            try {
+                await executeAction(page, action);
+                logs.push({
+                    step: index + 1,
+                    action: actionDescription(action),
+                    status: "passed",
+                    duration_ms: Date.now() - started,
+                    message: "Action completed",
+                });
+            }
+            catch (error) {
+                logs.push({
+                    step: index + 1,
+                    action: actionDescription(action),
+                    status: "failed",
+                    duration_ms: Date.now() - started,
+                    message: errorMessage(error),
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `QA flow failed at step ${index + 1}.`,
+                        },
+                    ],
+                    structuredContent: { passed: false, logs },
+                };
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `QA flow passed ${actions.length} action(s).`,
+                },
+            ],
+            structuredContent: { passed: true, logs },
+        };
+    }
+    catch (error) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `QA flow could not run: ${errorMessage(error)}`,
+                },
+            ],
+        };
+    }
+    finally {
+        await browser.close();
+    }
+});
+server.registerTool("compile_playwright_spec", {
+    title: "Compile Playwright spec",
+    description: "Write validated role-based actions to a Playwright spec in the local tests directory.",
+    inputSchema: {
+        test_name: z.string().min(1),
+        target_url: webUrlSchema,
+        validated_actions: z.array(qaActionSchema).min(1),
+    },
+    outputSchema: {
+        success: z.boolean(),
+        file_path: z.string(),
+        action_count: z.number(),
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ test_name, target_url, validated_actions }) => {
+    try {
+        const testsDirectory = path.resolve(process.cwd(), "tests");
+        const filePath = path.join(testsDirectory, `${safeSpecName(test_name)}.spec.ts`);
+        const actionLines = validated_actions.map(compileAction).join("\n");
+        const source = `import { test } from "playwright/test";\n\ntest(${JSON.stringify(test_name)}, async ({ page }) => {\n  await page.goto(${JSON.stringify(target_url)});\n${actionLines}\n});\n`;
+        await mkdir(testsDirectory, { recursive: true });
+        await writeFile(filePath, source, "utf8");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Created Playwright spec at ${filePath}.`,
+                },
+            ],
+            structuredContent: {
+                success: true,
+                file_path: filePath,
+                action_count: validated_actions.length,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Could not create Playwright spec: ${errorMessage(error)}`,
+                },
+            ],
+        };
+    }
+});
+async function main() {
+    const licenseKey = process.env.GUMROAD_LICENSE_KEY;
+    if (!licenseKey) {
+        throw new Error("GUMROAD_LICENSE_KEY is required");
+    }
+    const licensed = await verifyGumroadLicense(licenseKey, GUMROAD_PRODUCT_ID);
+    if (!licensed) {
+        throw new Error("Gumroad license verification failed");
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("ForgeQA-MCP is running on stdio");
+}
+main().catch((error) => {
+    console.error(`ForgeQA-MCP startup failed: ${errorMessage(error)}`);
+    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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"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@ltorrey/forgeqa-mcp",
+  "version": "1.0.0",
+  "description": "Commercial MCP server for local Playwright QA automation",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "forgeqa-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "smithery.yaml"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "node-fetch": "^3.3.2",
+    "playwright": "^1.63.0",
+    "zod": "^4.6.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.2",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2"
+  }
+}

package/smithery.yaml

@@ -0,0 +1,18 @@
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    required:
+      - GUMROAD_LICENSE_KEY
+    properties:
+      GUMROAD_LICENSE_KEY:
+        type: string
+        description: Gumroad license key for ForgeQA-MCP
+  commandFunction: |-
+    (config) => ({
+      command: 'node',
+      args: ['dist/index.js'],
+      env: { GUMROAD_LICENSE_KEY: config.GUMROAD_LICENSE_KEY }
+    })
+  exampleConfig:
+    GUMROAD_LICENSE_KEY: YOUR_GUMROAD_LICENSE_KEY