accessibility-server-mcp 1.0.0

package/config/wcag-rules.json

@@ -0,0 +1,252 @@
+{
+  "wcagRules": {
+    "2.0": {
+      "level": {
+        "A": [
+          "color-contrast",
+          "image-alt",
+          "label",
+          "link-name",
+          "button-name"
+        ],
+        "AA": [
+          "color-contrast-enhanced",
+          "focus-order-semantics",
+          "heading-order",
+          "html-has-lang"
+        ],
+        "AAA": [
+          "color-contrast-enhanced",
+          "focus-order-semantics"
+        ]
+      }
+    },
+    "2.1": {
+      "level": {
+        "A": [
+          "color-contrast",
+          "image-alt",
+          "label",
+          "link-name",
+          "button-name",
+          "aria-allowed-attr",
+          "aria-required-attr",
+          "aria-valid-attr-value",
+          "aria-valid-attr"
+        ],
+        "AA": [
+          "color-contrast-enhanced",
+          "focus-order-semantics",
+          "heading-order",
+          "html-has-lang",
+          "region",
+          "page-has-heading-one"
+        ],
+        "AAA": [
+          "color-contrast-enhanced",
+          "focus-order-semantics",
+          "target-size"
+        ]
+      }
+    },
+    "2.2": {
+      "level": {
+        "A": [
+          "color-contrast",
+          "image-alt",
+          "label",
+          "link-name",
+          "button-name",
+          "aria-allowed-attr",
+          "aria-required-attr",
+          "aria-valid-attr-value",
+          "aria-valid-attr",
+          "focus-order-semantics"
+        ],
+        "AA": [
+          "color-contrast-enhanced",
+          "focus-order-semantics",
+          "heading-order",
+          "html-has-lang",
+          "region",
+          "page-has-heading-one",
+          "target-size"
+        ],
+        "AAA": [
+          "color-contrast-enhanced",
+          "focus-order-semantics",
+          "target-size-enhanced"
+        ]
+      }
+    }
+  },
+  "categories": {
+    "color": [
+      "color-contrast",
+      "color-contrast-enhanced",
+      "link-in-text-block"
+    ],
+    "keyboard": [
+      "accesskeys",
+      "focus-order-semantics",
+      "focusable-content",
+      "tabindex"
+    ],
+    "images": [
+      "image-alt",
+      "image-redundant-alt",
+      "object-alt",
+      "input-image-alt"
+    ],
+    "headings": [
+      "heading-order",
+      "page-has-heading-one",
+      "empty-heading"
+    ],
+    "landmarks": [
+      "region",
+      "landmark-banner-is-top-level",
+      "landmark-complementary-is-top-level",
+      "landmark-contentinfo-is-top-level",
+      "landmark-main-is-top-level",
+      "landmark-no-duplicate-banner",
+      "landmark-no-duplicate-contentinfo",
+      "landmark-one-main"
+    ],
+    "forms": [
+      "label",
+      "label-title-only",
+      "form-field-multiple-labels",
+      "select-name"
+    ],
+    "links": [
+      "link-name",
+      "link-in-text-block"
+    ],
+    "tables": [
+      "table-caption",
+      "td-headers-attr",
+      "th-has-data-cells",
+      "table-duplicate-name"
+    ],
+    "aria": [
+      "aria-allowed-attr",
+      "aria-allowed-role",
+      "aria-dpub-role-fallback",
+      "aria-hidden-body",
+      "aria-hidden-focus",
+      "aria-input-field-name",
+      "aria-required-attr",
+      "aria-required-children",
+      "aria-required-parent",
+      "aria-roledescription",
+      "aria-roles",
+      "aria-valid-attr-value",
+      "aria-valid-attr"
+    ],
+    "structure": [
+      "bypass",
+      "document-title",
+      "html-has-lang",
+      "html-lang-valid",
+      "html-xml-lang-mismatch",
+      "valid-lang"
+    ]
+  },
+  "ruleDescriptions": {
+    "color-contrast": {
+      "title": "Color Contrast",
+      "description": "Ensures the contrast between foreground and background colors meets WCAG 2 AA contrast ratio thresholds",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/color-contrast",
+      "successCriteria": "1.4.3"
+    },
+    "image-alt": {
+      "title": "Images must have alternate text",
+      "description": "Ensures <img> elements have alternate text or a role of none or presentation",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/image-alt",
+      "successCriteria": "1.1.1"
+    },
+    "label": {
+      "title": "Form elements must have labels",
+      "description": "Ensures every form element has a label",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/label",
+      "successCriteria": "1.3.1, 3.3.2, 4.1.2"
+    },
+    "link-name": {
+      "title": "Links must have discernible text",
+      "description": "Ensures links have discernible text",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/link-name",
+      "successCriteria": "2.4.4, 4.1.2"
+    },
+    "button-name": {
+      "title": "Buttons must have discernible text",
+      "description": "Ensures buttons have discernible text",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/button-name",
+      "successCriteria": "4.1.2"
+    },
+    "heading-order": {
+      "title": "Heading levels should only increase by one",
+      "description": "Ensures the order of headings is semantically correct",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/heading-order",
+      "successCriteria": "1.3.1"
+    },
+    "html-has-lang": {
+      "title": "<html> element must have a lang attribute",
+      "description": "Ensures every HTML document has a lang attribute",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/html-has-lang",
+      "successCriteria": "3.1.1"
+    },
+    "aria-allowed-attr": {
+      "title": "ARIA attributes must conform to valid names",
+      "description": "Ensures ARIA attributes are allowed for an element's role",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/aria-allowed-attr",
+      "successCriteria": "4.1.2"
+    },
+    "aria-required-attr": {
+      "title": "Required ARIA attributes must be provided",
+      "description": "Ensures elements with ARIA roles have required ARIA attributes",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/aria-required-attr",
+      "successCriteria": "4.1.2"
+    },
+    "region": {
+      "title": "All page content should be contained by landmarks",
+      "description": "Ensures all page content is contained by landmarks",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/region",
+      "successCriteria": "1.3.1"
+    },
+    "target-size": {
+      "title": "Ensure touch targets have sufficient size and spacing",
+      "description": "Ensures touch targets are at least 24px by 24px",
+      "helpUrl": "https://dequeuniversity.com/rules/axe/4.6/target-size",
+      "successCriteria": "2.5.8"
+    }
+  },
+  "defaultSettings": {
+    "wcagLevel": "AA",
+    "wcagVersions": ["2.1"],
+    "includeExperimentalRules": false,
+    "timeout": 30000,
+    "viewport": {
+      "width": 1920,
+      "height": 1080
+    }
+  },
+  "contrastRequirements": {
+    "AA": {
+      "normal": 4.5,
+      "large": 3.0
+    },
+    "AAA": {
+      "normal": 7.0,
+      "large": 4.5
+    }
+  },
+  "targetSizeRequirements": {
+    "2.2": {
+      "AA": {
+        "minSize": 24,
+        "spacing": 24
+      }
+    }
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+type ServerMode = 'simple' | 'full';
+interface ServerConfig {
+    mode: ServerMode;
+    enableLogging: boolean;
+}
+/**
+ * Unified MCP server class for accessibility testing
+ * Supports both simple and full modes
+ */
+export declare class AccessibilityMCPServer {
+    private readonly server;
+    private readonly logger;
+    private readonly browserManager;
+    private readonly config;
+    private accessibilityTester?;
+    private colorContrastTester?;
+    private wcagValidator?;
+    private websiteAccessibilityTester?;
+    constructor(config?: ServerConfig);
+    /**
+     * Get or create accessibility tester (lazy loading)
+     */
+    private getAccessibilityTester;
+    /**
+     * Get or create color contrast tester (lazy loading)
+     */
+    private getColorContrastTester;
+    /**
+     * Get or create WCAG validator (lazy loading)
+     */
+    private getWCAGValidator;
+    /**
+     * Get or create website accessibility tester (lazy loading)
+     */
+    private getWebsiteAccessibilityTester;
+    /**
+     * Centralized error handling for all operations
+     */
+    private executeWithErrorHandling;
+    /**
+     * Set up MCP request handlers
+     */
+    private setupHandlers;
+    /**
+     * Set up graceful shutdown handling
+     */
+    private setupGracefulShutdown;
+    /**
+     * Start the MCP server
+     */
+    run(): Promise<void>;
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAuBA,KAAK,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpC,UAAU,YAAY;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB;AAsCD;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAGtC,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,0BAA0B,CAAC,CAA6B;gBAEpD,MAAM,GAAE,YAAoD;IAwBxE;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAOrC;;OAEG;YACW,wBAAwB;IA8CtC;;OAEG;IACH,OAAO,CAAC,aAAa;IA8OrB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}