mcp-accessibility-scanner 1.0.0 → 1.0.1

package/Readme.md

@@ -1,6 +1,6 @@
-# MCP Accessibility Scanner
+# MCP Accessibility Scanner 🔍
 
-A Model Context Protocol (MCP) server for performing automated accessibility scans of web pages using Playwright and Axe-core.
+A Model Context Protocol (MCP) server that provides automated web accessibility scanning using Playwright and Axe-core. This server enables LLMs to perform WCAG compliance checks, capture annotated screenshots, and generate detailed accessibility reports.
 
 ## Features
 
@@ -10,30 +10,47 @@ A Model Context Protocol (MCP) server for performing automated accessibility sca
 
 ## Installation
 
+You can install the package using any of these methods:
+
+Using npm:
 ```bash
-# Clone repository
-git clone https://github.com/JustasMonkev/mcp-accessibility-scanner.git
-cd mcp-accessibility-scanner
+npm install -g mcp-accessibility-scanner
+```
 
-# Install dependencies
-npm install
+Using mcp-get:
+```bash
+npx @michaellatman/mcp-get@latest install mcp-accessibility-scanner
+```
+
+Using Smithery (for Claude Desktop):
+```bash
+npx -y @smithery/cli install mcp-accessibility-scanner --client claude
+```
+
+### Installation in VS Code
+
+Install the Accessibility Scanner in VS Code using the VS Code CLI:
 
-# Build project (compiles TypeScript and installs Playwright browsers)
-npm run prepare
+For VS Code:
+```bash
+code --add-mcp '{"name":"accessibility-scanner","command":"npx","args":["mcp-accessibility-scanner"]}'
+```
+
+For VS Code Insiders:
+```bash
+code-insiders --add-mcp '{"name":"accessibility-scanner","command":"npx","args":["mcp-accessibility-scanner"]}'
 ```
 
-## Claude Desktop Configuration
+## Configuration
 
-Add the following to your Claude Desktop settings to enable the Accessibility Scanner server:
+Here's the Claude Desktop configuration:
 
 ```json
 {
   "mcpServers": {
-    "accessibility-checker": {
-      "command": "node",
-      "args": [
-        "path/build/server.js"
-      ]
+    "accessibility-scanner": {
+      "command": "npx",
+      "args": ["-y", "mcp-accessibility-scanner"]
     }
   }
 }
@@ -44,7 +61,7 @@ Add the following to your Claude Desktop settings to enable the Accessibility Sc
 The scanner exposes a single tool `scan_accessibility` that accepts:
 
 - `url`: The webpage URL to scan
-- `violationsTag`: Array of accessibility violation tags to check
+- `violationsTag`: Array of accessibility violation tags to check (optional)
 
 Example usage in Claude:
 ```
@@ -53,6 +70,13 @@ Could you scan example.com for accessibility issues related to color contrast?
 
 ## Development
 
+Clone and set up the project:
+```bash
+git clone https://github.com/JustasMonkev/mcp-accessibility-scanner.git
+cd mcp-accessibility-scanner
+npm install
+```
+
 Start the TypeScript compiler in watch mode:
 ```bash
 npm run watch
@@ -65,17 +89,16 @@ npm run inspector
 
 ## Project Structure
 
-- `src/`: Source code
-    - `index.ts`: MCP server setup and tool definitions
-    - `accessibilityChecker.ts`: Core scanning functionality
-- `dist/`: Compiled JavaScript output
-- `package.json`: Project dependencies and scripts
-- `tsconfig.json`: TypeScript configuration
+```
+├── src/              # Source code
+│   ├── index.ts     # MCP server setup and tool definitions
+│   └── scanner.ts   # Core scanning functionality
+├── build/           # Compiled JavaScript output
+├── package.json     # Project configuration and dependencies
+└── tsconfig.json    # TypeScript configuration
+```
 
-## Output
+## License
 
-The scanner provides:
-1. A visual report with numbered violations highlighted on the page
-2. A detailed JSON report of all found violations
-3. A full-page screenshot saved to Downloads
+MIT
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-accessibility-scanner",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A Model Context Protocol (MCP) server for performing automated accessibility scans of web pages using Playwright and Axe-core",
   "main": "build/index.js",
   "types": "build/index.d.ts",