a11y-test-mcp 1.1.0 → 1.1.1

package/README.md

@@ -1,16 +1,17 @@
 # a11y test MCP
+
 An MCP (Model Context Protocol) server for performing a11y test on webpages using playwright axe-core. The results are then used in an agent loop with your favorite AI assistant (Cline/Cursor/GH Copilot) to find problems with a11y and suggest improvements.
 
 ## Features
 
-* Perform detailed accessibility testing on any web pages
-* Get an overview of accessibility issues
-  * Violations
-    * Provides information on which DOM was at fault
-  * Passes
-  * Incomplete
-  * Inapplicable
-* Can specify specific WCAG criteria（Default WCAG 2.0 level A, WCAG 2.0 level AA, WCAG 2.1 level A, WCAG 2.1 level AA）
+- Perform detailed accessibility testing on any web pages
+- Get an overview of accessibility issues
+  - Violations
+    - Provides information on which DOM was at fault
+  - Passes
+  - Incomplete
+  - Inapplicable
+- Can specify specific WCAG criteria（Default WCAG 2.0 level A, WCAG 2.0 level AA, WCAG 2.1 level A, WCAG 2.1 level AA）
 
 ## Installation
 

package/build/constants.js

@@ -18,4 +18,4 @@ exports.WCAG_TAG_MAP = {
 /** Allow prefixes or tags */
 exports.ALLOWED_PREFIXES_OR_TAGS = ['wcag', 'best-practice', 'section508'];
 /** default WCAG tags */
-exports.DEFAULT_WCAG_TAGS = ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa"];
+exports.DEFAULT_WCAG_TAGS = ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'];

package/build/functions.js

@@ -4,8 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertTestResultToText = exports.execTest = void 0;
-const playwright_1 = __importDefault(require("playwright"));
-const playwright_2 = __importDefault(require("@axe-core/playwright"));
+const playwright_1 = __importDefault(require("@axe-core/playwright"));
+const playwright_2 = require("playwright");
 const constants_1 = require("./constants");
 /**
  * Enhance WCAG tag conversion
@@ -45,7 +45,7 @@ const formatViolation = (v) => {
  * @returns {AccessibilityTestOutput[]} - Results of the accessibility tests
  */
 const execTest = async (urls, wcagStandards) => {
-    const browser = await playwright_1.default.chromium.launch();
+    const browser = await playwright_2.chromium.launch();
     const context = await browser.newContext();
     const tagsToUse = (wcagStandards && wcagStandards.length > 0)
         ? convertWcagTag(wcagStandards)
@@ -56,7 +56,7 @@ const execTest = async (urls, wcagStandards) => {
             try {
                 page = await context.newPage();
                 await page.goto(url, { waitUntil: 'networkidle' });
-                const axeBuilder = new playwright_2.default({ page });
+                const axeBuilder = new playwright_1.default({ page });
                 axeBuilder.withTags(tagsToUse);
                 const axeResults = await axeBuilder.analyze();
                 const summarizedViolations = axeResults.violations.map(v => ({
@@ -64,7 +64,7 @@ const execTest = async (urls, wcagStandards) => {
                     impact: v.impact === null ? undefined : v.impact,
                     description: v.description,
                     helpUrl: v.helpUrl,
-                    nodes: v.nodes
+                    nodes: v.nodes,
                 }));
                 return {
                     url: url,

package/build/index.js

@@ -15,8 +15,8 @@ server.tool('exec-a11y-test', 'Obtains a list of specified list of URL and a lis
     return {
         content: [{
                 type: 'text',
-                text: (0, functions_1.convertTestResultToText)(structuredResults)
-            }]
+                text: (0, functions_1.convertTestResultToText)(structuredResults),
+            }],
     };
 });
 /**

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "a11y-test-mcp",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "main": "build/index.js",
   "scripts": {
     "postinstall": "npx -y playwright install",
     "build": "tsc && chmod 755 build/index.js",
     "start": "node build/index.js",
-    "lint": "eslint .",
-    "format": "npm run lint -- --fix"
+    "lint": "npm run lint:e && npm run lint:d",
+    "lint:e": "eslint .",
+    "lint:d": "dprint check",
+    "format": "dprint fmt"
   },
   "bin": {
     "a11y-test-mcp": "build/index.js"
@@ -43,6 +45,7 @@
   "devDependencies": {
     "@eslint/js": "^9.25.1",
     "@types/node": "^22.15.2",
+    "dprint": "^0.49.1",
     "eslint": "^9.25.1",
     "eslint-config-flat-gitignore": "^2.1.0",
     "typescript": "^5.8.3",

package/build/constants.d.ts

@@ -1,6 +0,0 @@
-/** WCAG tag map */
-export declare const WCAG_TAG_MAP: Record<string, string>;
-/** Allow prefixes or tags */
-export declare const ALLOWED_PREFIXES_OR_TAGS: string[];
-/** default WCAG tags */
-export declare const DEFAULT_WCAG_TAGS: string[];

package/build/functions.d.ts

@@ -1,14 +0,0 @@
-import type { AccessibilityTestOutput } from './types';
-/**
- * Execute a11y test
- * @param {string[]} urls - URLs
- * @param {string[] | undefined} wcagStandards - WCAG standards to apply
- * @returns {AccessibilityTestOutput[]} - Results of the accessibility tests
- */
-export declare const execTest: (urls: string[], wcagStandards: string[] | undefined) => Promise<AccessibilityTestOutput[]>;
-/**
- * Convert structured results to text format
- * @param {AccessibilityTestOutput[]} structuredResults - Structured results from the tests
- * @returns {string} - Text representation of the results
- */
-export declare const convertTestResultToText: (structuredResults: AccessibilityTestOutput[]) => string;

package/build/index.d.ts

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

package/build/types.d.ts

@@ -1,17 +0,0 @@
-import type { NodeResult } from 'axe-core';
-export interface ViolationSummary {
-    id: string;
-    impact?: 'minor' | 'moderate' | 'serious' | 'critical';
-    description: string;
-    helpUrl: string;
-    nodes: NodeResult[];
-}
-/** Update the main output structure */
-export interface AccessibilityTestOutput {
-    url: string;
-    violations?: ViolationSummary[];
-    passesCount?: number;
-    incompleteCount?: number;
-    inapplicableCount?: number;
-    error?: string;
-}

package/build/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });