genat-mcp 1.2.5 → 2.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -85,6 +85,12 @@ N8N_WEBHOOK_URL='https://your-n8n/webhook-test/webhook-genat-login' N8N_INSECURE
85
85
 
86
86
  **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.
87
87
 
88
+ **Projects using GenAT:** Copy the Cursor rule so the AI uses the correct webhook when creating workarounds:
89
+ ```bash
90
+ mkdir -p .cursor/rules
91
+ cp node_modules/genat-mcp/rules/genat-mcp.mdc .cursor/rules/
92
+ ```
93
+
88
94
  ## Tool: GenAT
89
95
 
90
96
  - **url** (string): Page URL to analyze for accessibility.
package/index.js CHANGED
@@ -51,7 +51,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
51
51
  const server = new McpServer(
52
52
  {
53
53
  name: 'GenAT',
54
- version: '1.2.5',
54
+ version: '2.1.1',
55
55
  },
56
56
  {
57
57
  capabilities: {
package/package.json CHANGED
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "genat-mcp",
3
- "version": "1.2.5",
3
+ "version": "2.1.1",
4
4
  "mcpName": "io.github.asokans@oclc.org/genat",
5
5
  "description": "MCP server GenAT: generate accessibility tests via n8n workflow (url + project folder)",
6
6
  "type": "module",
7
7
  "main": "index.js",
8
8
  "bin": { "genat-mcp": "index.js" },
9
9
  "engines": { "node": ">=20" },
10
- "files": ["index.js", "detect-framework.js", "detect-login.js", "write-files.js", "run-genat.mjs"],
10
+ "files": ["index.js", "detect-framework.js", "detect-login.js", "write-files.js", "run-genat.mjs", "rules/genat-mcp.mdc"],
11
11
  "keywords": ["mcp", "accessibility", "playwright", "n8n", "model-context-protocol", "a11y", "testing"],
12
12
  "repository": {
13
13
  "type": "git",
@@ -0,0 +1,29 @@
1
+ ---
2
+ description: GenAT MCP and run-genat workaround - use webhook-genat-login
3
+ alwaysApply: true
4
+ ---
5
+
6
+ # GenAT MCP and run-genat.mjs Workaround
7
+
8
+ ## When GenAT MCP fails
9
+
10
+ - **Do NOT** write files from a previous successful MCP run or cached output
11
+ - **Do** inform the user that the MCP call failed and why
12
+ - **Do** suggest steps to fix (webhook URL, network, n8n workflow activation)
13
+ - **Do** wait for the user to resolve the MCP connection before generating files
14
+
15
+ Only write generated files when the MCP tool returns a successful response.
16
+
17
+ ## When creating run-genat.mjs as a workaround
18
+
19
+ **CRITICAL: Use webhook-genat-login, NOT webhook-genat.** The webhook path must end with `webhook-genat-login`. Using `webhook-genat` causes 404.
20
+
21
+ - **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.
22
+ - **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`.
23
+ - **N8N_WEBHOOK_URL** must point to `.../webhook-test/webhook-genat-login`
24
+ - **N8N_INSECURE_TLS=1** for self-signed certs (e.g. K8s)
25
+
26
+ Example:
27
+ ```bash
28
+ 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 .
29
+ ```