genat-mcp 1.2.3 → 1.2.5

package/README.md

@@ -32,7 +32,7 @@ npm install /path/to/n8n_playwright_tests/mcp-genat
 
 | Variable           | Required | Default | Description |
 |--------------------|----------|---------|-------------|
-| **N8N_WEBHOOK_URL** | No       | `http://localhost:5678/webhook-test/webhook-genat` | n8n GenAT webhook URL. Set this if your n8n instance is elsewhere (e.g. `https://your-n8n-host/webhook-test/webhook-genat`). |
+| **N8N_WEBHOOK_URL** | No       | `http://localhost:5678/webhook-test/webhook-genat-login` | n8n GenAT webhook URL. Set this if your n8n instance is elsewhere (e.g. `https://your-n8n-host/webhook-test/webhook-genat-login`). |
 | **N8N_INSECURE_TLS** | No       | (off)   | Set to `1`, `true`, or `yes` to skip TLS certificate verification for HTTPS webhooks. Use only for dev/internal n8n with self-signed or internal CA certs (e.g. K8s). Not recommended for production. |
 | **SERVICE_BASE_URL** | No       | (none)  | Base URL for DOM Analyzer and Accessibility Analyzer (e.g. `http://host.docker.internal` or `http://your-tunnel.ngrok.io`). Required when n8n runs on a remote host (K8s) so the workflow can reach the services. The workflow appends `:3456/analyze-dom` and `:3458/analyze-accessibility`. |
 
@@ -68,9 +68,23 @@ If the global binary is not on PATH, use the full path, e.g. `node $(npm root -g
 ## Requirements
 
 - **Node.js** 20+
-- **n8n** with the [GenAT workflow](../workflows/genat-accessibility-tests.json) imported and activated (webhook path `webhook-test/webhook-genat`)
+- **n8n** with the [GenAT workflow](../workflows/genat-accessibility-tests-with-login.json) imported and activated (webhook path `webhook-test/webhook-genat-login`)
 - **DOM Analyzer** and **Accessibility Analyzer** services running (see main README: `npm run services` from repo root)
 
+## Standalone script: run-genat.mjs
+
+When the MCP fails (e.g. TLS/connection issues), use the standalone script:
+
+```bash
+# From a project that has genat-mcp installed
+N8N_WEBHOOK_URL='https://your-n8n/webhook-test/webhook-genat-login' N8N_INSECURE_TLS=1 node node_modules/genat-mcp/run-genat.mjs https://example.com .
+
+# Or from mcp-genat directory
+N8N_WEBHOOK_URL='https://your-n8n/webhook-test/webhook-genat-login' N8N_INSECURE_TLS=1 node run-genat.mjs https://example.com /path/to/project
+```
+
+**Important:** Use `webhook-genat-login` (not `webhook-genat`). Import and activate [genat-accessibility-tests-with-login.json](../workflows/genat-accessibility-tests-with-login.json) in n8n.
+
 ## Tool: GenAT
 
 - **url** (string): Page URL to analyze for accessibility.

package/index.js

@@ -12,7 +12,7 @@ import { detectFramework } from './detect-framework.js';
 import { detectLogin } from './detect-login.js';
 import { writeGeneratedFiles } from './write-files.js';
 
-const N8N_WEBHOOK_URL = process.env.N8N_WEBHOOK_URL || 'http://localhost:5678/webhook-test/webhook-genat';
+const N8N_WEBHOOK_URL = process.env.N8N_WEBHOOK_URL || 'http://localhost:5678/webhook-test/webhook-genat-login';
 const SERVICE_BASE_URL = process.env.SERVICE_BASE_URL || null;
 const N8N_INSECURE_TLS = /^1|true|yes$/i.test(process.env.N8N_INSECURE_TLS || '');
 
@@ -51,7 +51,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
 const server = new McpServer(
   {
     name: 'GenAT',
-    version: '1.2.3',
+    version: '1.2.5',
   },
   {
     capabilities: {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "genat-mcp",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "mcpName": "io.github.asokans@oclc.org/genat",
   "description": "MCP server GenAT: generate accessibility tests via n8n workflow (url + project folder)",
   "type": "module",
   "main": "index.js",
   "bin": { "genat-mcp": "index.js" },
   "engines": { "node": ">=20" },
-  "files": ["index.js", "detect-framework.js", "detect-login.js", "write-files.js"],
+  "files": ["index.js", "detect-framework.js", "detect-login.js", "write-files.js", "run-genat.mjs"],
   "keywords": ["mcp", "accessibility", "playwright", "n8n", "model-context-protocol", "a11y", "testing"],
   "repository": {
     "type": "git",

package/run-genat.mjs

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * Standalone GenAT script: calls the n8n webhook directly and writes generated files.
+ * Use when the MCP fails (e.g. TLS/connection issues). Defaults to webhook-genat-login.
+ *
+ * Usage:
+ *   node run-genat.mjs <url> [parentProjectFolder]
+ *   N8N_WEBHOOK_URL='https://your-n8n/webhook-test/webhook-genat-login' node run-genat.mjs <url> .
+ *
+ * Env:
+ *   N8N_WEBHOOK_URL - webhook URL (default: http://localhost:5678/webhook-test/webhook-genat-login)
+ *   N8N_INSECURE_TLS - set to 1 for self-signed/internal certs
+ */
+import https from 'node:https';
+import { resolve } from 'node:path';
+import { detectFramework } from './detect-framework.js';
+import { detectLogin } from './detect-login.js';
+import { writeGeneratedFiles } from './write-files.js';
+
+const DEFAULT_WEBHOOK = 'http://localhost:5678/webhook-test/webhook-genat-login';
+const N8N_WEBHOOK_URL = process.env.N8N_WEBHOOK_URL || DEFAULT_WEBHOOK;
+const N8N_INSECURE_TLS = /^1|true|yes$/i.test(process.env.N8N_INSECURE_TLS || '');
+
+function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
+  return new Promise((resolve, reject) => {
+    const req = https.request(
+      url,
+      {
+        method,
+        headers: { 'Content-Type': 'application/json', ...headers },
+        agent: new https.Agent({ rejectUnauthorized: false }),
+      },
+      (res) => {
+        let data = '';
+        res.on('data', (chunk) => (data += chunk));
+        res.on('end', () => {
+          resolve({
+            ok: res.statusCode >= 200 && res.statusCode < 300,
+            status: res.statusCode ?? 0,
+            text: () => Promise.resolve(data),
+            json: () => Promise.resolve(JSON.parse(data || 'null')),
+          });
+        });
+      }
+    );
+    req.on('error', reject);
+    if (body) req.write(typeof body === 'string' ? body : JSON.stringify(body));
+    req.end();
+  });
+}
+
+async function main() {
+  const url = process.argv[2];
+  const parentProjectFolder = resolve(process.argv[3] || '.');
+
+  if (!url) {
+    console.error('Usage: node run-genat.mjs <url> [parentProjectFolder]');
+    console.error('Example: N8N_WEBHOOK_URL=https://your-n8n/webhook-test/webhook-genat-login node run-genat.mjs https://example.com .');
+    process.exit(1);
+  }
+
+  let framework;
+  try {
+    framework = detectFramework(parentProjectFolder);
+  } catch (err) {
+    framework = { scriptType: 'typescript', bddFramework: 'none', pageObject: false, projectSummary: '' };
+  }
+
+  let login = {};
+  try {
+    login = detectLogin(parentProjectFolder) || {};
+  } catch (_) {}
+
+  const body = {
+    url,
+    scriptType: framework.scriptType,
+    bddFramework: framework.bddFramework,
+    pageObject: framework.pageObject,
+    projectSummary: framework.projectSummary,
+    ...(login.username && { loginUsername: login.username }),
+    ...(login.password && { loginPassword: login.password }),
+    ...(login.loginUrl && { loginUrl: login.loginUrl }),
+    ...(login.usernameSelector && { loginUsernameSelector: login.usernameSelector }),
+    ...(login.passwordSelector && { loginPasswordSelector: login.passwordSelector }),
+    ...(login.submitSelector && { loginSubmitSelector: login.submitSelector }),
+  };
+
+  const fetchOpts = {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(body),
+  };
+
+  const useInsecureTls = N8N_INSECURE_TLS && N8N_WEBHOOK_URL.startsWith('https://');
+  const response = useInsecureTls
+    ? await insecureHttpsFetch(N8N_WEBHOOK_URL, fetchOpts)
+    : await fetch(N8N_WEBHOOK_URL, fetchOpts);
+
+  if (!response.ok) {
+    const text = await response.text();
+    console.error(`GenAT reached the n8n webhook, but n8n responded with ${response.status}:`);
+    console.error(text);
+    process.exit(1);
+  }
+
+  const data = await response.json();
+  const written = await writeGeneratedFiles(parentProjectFolder, data);
+  console.log('GenAT wrote:', written.join(', '));
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});