Accessibility MCP

An MCP (Model Context Protocol) server for accessibility checking and rule validation. This tool scans TypeScript files for common accessibility and code quality violations.

Installation

Install the package globally or locally:

npm install -g accessibility-mcp

Or install locally in your project:

npm install accessibility-mcp

Configuration

Add the following to your mcp.json configuration file (used by Cursor, Copilot, and other MCP-compatible tools):

Global Installation

{
  "mcpServers": {
    "accessibility": {
      "command": "node",
      "args": [
        "/path/to/global/node_modules/accessibility-mcp/build/index.js"
      ]
    }
  }
}

Local Installation

{
  "mcpServers": {
    "accessibility": {
      "command": "node",
      "args": [
        "./node_modules/accessibility-mcp/build/index.js"
      ]
    }
  }
}

Using npx (Recommended)

{
  "mcpServers": {
    "accessibility": {
      "command": "npx",
      "args": [
        "accessibility-mcp"
      ]
    }
  }
}

Features

• Rule-based checking: Configurable rules for code quality and accessibility
• TypeScript support: Designed for TypeScript codebases
• MCP integration: Works seamlessly with Cursor, Copilot, and other MCP tools

Available Tools

checkRules

Scans a TypeScript file for rule violations.

Parameters:

• filePath (string): Path to the TypeScript file to check

Example usage in Cursor/Copilot:

Check accessibility rules in src/components/Button.tsx

Rules Configuration

The tool comes with a default set of rules in rules.json. Current rules include:

• no-todo: Detects TODO comments that should be removed
• no-console: Detects console.log calls that should be removed

Development

To build the project:

npm run build

To start the MCP server directly:

npm start

License

ISC