genat-mcp 2.1.0 → 2.1.2

package/README.md

@@ -85,6 +85,27 @@ N8N_WEBHOOK_URL='https://your-n8n/webhook-test/webhook-genat-login' N8N_INSECURE
 
 **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.
 
+**Optional – Cursor rule:** Copy the rule so the AI uses the correct webhook when creating workarounds (the MCP error responses also include this hint):
+```bash
+mkdir -p .cursor/rules
+# If genat-mcp is installed in the project:
+cp node_modules/genat-mcp/rules/genat-mcp.mdc .cursor/rules/
+# Or from the n8n_playwright_tests repo (if you have it):
+cp /path/to/n8n_playwright_tests/mcp-genat/rules/genat-mcp.mdc .cursor/rules/
+```
+If the rule file is missing (e.g. genat-mcp installed from npm before rules were added), create `.cursor/rules/genat-mcp.mdc` with:
+
+```markdown
+---
+description: GenAT MCP and run-genat workaround - use webhook-genat-login
+alwaysApply: true
+---
+
+# GenAT MCP and run-genat.mjs Workaround
+
+When creating run-genat.mjs: Use webhook-genat-login, NOT webhook-genat. Prefer `node node_modules/genat-mcp/run-genat.mjs <url> .` Never use webhook-genat.
+```
+
 ## Tool: GenAT
 
 - **url** (string): Page URL to analyze for accessibility.

package/index.js

@@ -51,7 +51,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
 const server = new McpServer(
   {
     name: 'GenAT',
-    version: '2.1.0',
+    version: '2.1.2',
   },
   {
     capabilities: {
@@ -64,7 +64,7 @@ server.registerTool(
   'GenAT',
   {
     description:
-      'Generate accessibility tests for a URL based on the project folder. Analyzes the page (DOM + a11y), detects project framework (TypeScript, JavaScript, or Python, BDD, Page Object), and returns generated test files (feature, spec/step defs, page objects). Optionally write files to the project folder.',
+      'Generate accessibility tests for a URL based on the project folder. Analyzes the page (DOM + a11y), detects project framework (TypeScript, JavaScript, or Python, BDD, Page Object), and returns generated test files (feature, spec/step defs, page objects). Optionally write files to the project folder. On failure: use node node_modules/genat-mcp/run-genat.mjs (webhook-genat-login). Do not create run-genat.mjs with webhook-genat.',
     inputSchema: {
       url: z.string().describe('Page URL to analyze for accessibility (e.g. https://example.com)'),
       parentProjectFolder: z
@@ -142,6 +142,7 @@ server.registerTool(
               error: 'Failed to call n8n webhook',
               message: err instanceof Error ? err.message : String(err),
               hint: 'Set N8N_WEBHOOK_URL to your n8n webhook URL. For self-signed/internal certs, set N8N_INSECURE_TLS=1',
+              workaround: 'Run: N8N_WEBHOOK_URL=\'https://your-n8n/webhook-test/webhook-genat-login\' N8N_INSECURE_TLS=1 node node_modules/genat-mcp/run-genat.mjs "<url>" .  Use webhook-genat-login (not webhook-genat). Do not create run-genat.mjs with webhook-genat.',
             }),
           },
         ],
@@ -151,6 +152,7 @@ server.registerTool(
 
     if (!response.ok) {
       const text = await response.text();
+      const is404 = response.status === 404;
       return {
         content: [
           {
@@ -158,6 +160,9 @@ server.registerTool(
             text: JSON.stringify({
               error: `n8n returned ${response.status}`,
               body: text.slice(0, 1000),
+              ...(is404 && {
+                workaround: 'Use webhook-genat-login (not webhook-genat). Run: N8N_WEBHOOK_URL=\'https://your-n8n/webhook-test/webhook-genat-login\' N8N_INSECURE_TLS=1 node node_modules/genat-mcp/run-genat.mjs "<url>" .  Do not create run-genat.mjs with webhook-genat.',
+              }),
             }),
           },
         ],

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "genat-mcp",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "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", "run-genat.mjs"],
+  "files": ["index.js", "detect-framework.js", "detect-login.js", "write-files.js", "run-genat.mjs", "rules/genat-mcp.mdc"],
   "keywords": ["mcp", "accessibility", "playwright", "n8n", "model-context-protocol", "a11y", "testing"],
   "repository": {
     "type": "git",

package/rules/genat-mcp.mdc

@@ -0,0 +1,29 @@
+---
+description: GenAT MCP and run-genat workaround - use webhook-genat-login
+alwaysApply: true
+---
+
+# GenAT MCP and run-genat.mjs Workaround
+
+## When GenAT MCP fails
+
+- **Do NOT** write files from a previous successful MCP run or cached output
+- **Do** inform the user that the MCP call failed and why
+- **Do** suggest steps to fix (webhook URL, network, n8n workflow activation)
+- **Do** wait for the user to resolve the MCP connection before generating files
+
+Only write generated files when the MCP tool returns a successful response.
+
+## When creating run-genat.mjs as a workaround
+
+**CRITICAL: Use webhook-genat-login, NOT webhook-genat.** The webhook path must end with `webhook-genat-login`. Using `webhook-genat` causes 404.
+
+- **Prefer:** Have the user run `node node_modules/genat-mcp/run-genat.mjs <url> .` (if genat-mcp is installed). This script defaults to webhook-genat-login.
+- **If creating a new run-genat.mjs:** Copy from `node_modules/genat-mcp/run-genat.mjs` or ensure the default webhook is `.../webhook-test/webhook-genat-login`. Never use `webhook-genat`.
+- **N8N_WEBHOOK_URL** must point to `.../webhook-test/webhook-genat-login`
+- **N8N_INSECURE_TLS=1** for self-signed certs (e.g. K8s)
+
+Example:
+```bash
+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 .
+```