genat-mcp 2.2.2 → 2.2.3

package/README.md

@@ -38,6 +38,7 @@ npm install /path/to/n8n_playwright_tests/mcp-genat
 | **N8N_MAX_ASSERTIONS** | No       | (none)  | Override assertion count for complex pages (e.g. `25`). Used as default when the tool is invoked without `maxAssertions`; also used by run-genat.mjs. |
 | **N8N_SCOPE_TO_REGIONS** | No       | (none)  | Comma-separated regions to focus tests on (e.g. `header,main,table`). Used as default when the tool is invoked without `scopeToRegions`; also used by run-genat.mjs. |
 | **N8N_ANALYZE_STATES** | No       | (off)   | Set to `1`, `true`, or `yes` to analyze dropdown/combobox expanded states and include state-specific violations in generated tests. Used as default when the tool is invoked without `analyzeStates`; also used by run-genat.mjs. Increases analysis time. |
+| **GENAT_PROJECT_ROOT** | No       | (cwd)   | Base path for resolving `parentProjectFolder`. When set, `parentProjectFolder` is resolved relative to this path. Use when your project is outside the MCP's working directory. Example: if your pytest project is at `/Users/me/projects/ill_tests`, set `GENAT_PROJECT_ROOT=/Users/me/projects` and use `parentProjectFolder ill_tests` in the prompt. |
 
 ## Cursor MCP config
 
@@ -84,6 +85,23 @@ npm install /path/to/n8n_playwright_tests/mcp-genat
 }
 ```
 
+**With GENAT_PROJECT_ROOT** (when project is outside MCP working directory):
+
+```json
+{
+  "mcpServers": {
+    "GenAT": {
+      "command": "npx",
+      "args": ["genat-mcp"],
+      "env": {
+        "GENAT_PROJECT_ROOT": "/Users/me/projects"
+      }
+    }
+  }
+}
+```
+Then use `parentProjectFolder ill_tests` in the prompt to target `/Users/me/projects/ill_tests`.
+
 **With optional params for complex pages** (`N8N_MAX_ASSERTIONS`, `N8N_SCOPE_TO_REGIONS`, `N8N_ANALYZE_STATES`):
 
 ```json

package/index.js

@@ -5,6 +5,7 @@
  * Detects framework (language, BDD, Page Object), POSTs to n8n webhook, returns generated files.
  */
 import https from 'node:https';
+import path from 'node:path';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
@@ -51,7 +52,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
 const server = new McpServer(
   {
     name: 'GenAT',
-    version: '2.2.2',
+    version: '2.2.3',
   },
   {
     capabilities: {
@@ -69,7 +70,7 @@ server.registerTool(
       url: z.string().describe('Page URL to analyze for accessibility (e.g. https://example.com)'),
       parentProjectFolder: z
         .string()
-        .describe('Absolute or relative path to the project root containing TypeScript, JavaScript, or Python Playwright code'),
+        .describe('Absolute or relative path to the project root. When GENAT_PROJECT_ROOT is set, resolved relative to it; otherwise relative to process.cwd().'),
       writeToProject: z
         .boolean()
         .optional()
@@ -101,7 +102,7 @@ server.registerTool(
       jiraNumber: z
         .string()
         .optional()
-        .describe('JIRA issue key (e.g. PROJ-123) for acceptance criteria'),
+        .describe('JIRA issue key (e.g. PROJ-123, RB-40039). Extract from prompts like "JIRA RB-40039" or "JIRA ticket PROJ-123". Pass only the key (e.g. RB-40039), not "JIRA RB-40039".'),
     },
   },
   async ({ url, parentProjectFolder, writeToProject, maxAssertions, scopeToRegions, analyzeStates, loginUsername, loginPassword, loginUrl, jiraNumber }) => {
@@ -112,9 +113,12 @@ server.registerTool(
       };
     }
 
+    const base = process.env.GENAT_PROJECT_ROOT || process.cwd();
+    const resolvedPath = path.resolve(base, parentProjectFolder || '.');
+
     let framework;
     try {
-      framework = detectFramework(parentProjectFolder || '.');
+      framework = detectFramework(resolvedPath);
     } catch (err) {
       return {
         content: [
@@ -133,7 +137,7 @@ server.registerTool(
 
     let login = {};
     try {
-      login = detectLogin(parentProjectFolder || '.') || {};
+      login = detectLogin(resolvedPath) || {};
     } catch (_) {}
 
     // Tool params override .env
@@ -226,9 +230,9 @@ server.registerTool(
       };
     }
 
-    if (writeToProject && parentProjectFolder && data) {
+    if (writeToProject && resolvedPath && data) {
       try {
-        const written = writeGeneratedFiles(parentProjectFolder, data);
+        const written = writeGeneratedFiles(resolvedPath, data);
         data._written = written;
       } catch (err) {
         data._writeError = err instanceof Error ? err.message : String(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genat-mcp",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "mcpName": "io.github.asokans@oclc.org/genat",
   "description": "MCP server GenAT: generate accessibility tests via n8n workflow (url + project folder)",
   "type": "module",