mcp-accessibility-scanner 1.0.6 → 1.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/Readme.md +141 -103
- package/build/accessibilityChecker.js +61 -61
- package/build/index.js +11 -9
- package/build/server.js +10 -10
- package/package.json +54 -53
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025 JustasM
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 JustasM
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/Readme.md
CHANGED
|
@@ -1,103 +1,141 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
npm
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
##
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
1
|
+
[](https://mseep.ai/app/justasmonkev-mcp-accessibility-scanner)
|
|
2
|
+
|
|
3
|
+
# MCP Accessibility Scanner 🔍
|
|
4
|
+
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
✅ Full WCAG 2.1/2.2 compliance checking
|
|
10
|
+
🖼️ Automatic screenshot capture with violation highlighting
|
|
11
|
+
📄 Detailed JSON reports with remediation guidance
|
|
12
|
+
|
|
13
|
+
## Installation
|
|
14
|
+
|
|
15
|
+
You can install the package using any of these methods:
|
|
16
|
+
|
|
17
|
+
Using npm:
|
|
18
|
+
```bash
|
|
19
|
+
npm install -g mcp-accessibility-scanner
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
### Docker Installation
|
|
23
|
+
|
|
24
|
+
The project includes a Dockerfile that sets up all necessary dependencies including Node.js v22 and Python 3.13.
|
|
25
|
+
|
|
26
|
+
1. Build the Docker image:
|
|
27
|
+
```bash
|
|
28
|
+
docker build -t mcp-server .
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
2. Run the container:
|
|
32
|
+
```bash
|
|
33
|
+
docker run -it -e MCP_PROXY_DEBUG=true mcp-server
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
You can also run it in the background:
|
|
37
|
+
```bash
|
|
38
|
+
docker run -d -p 3000:3000 mcp-server
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### Installation in VS Code
|
|
42
|
+
|
|
43
|
+
Install the Accessibility Scanner in VS Code using the VS Code CLI:
|
|
44
|
+
|
|
45
|
+
For VS Code:
|
|
46
|
+
```bash
|
|
47
|
+
code --add-mcp '{"name":"accessibility-scanner","command":"npx","args":["mcp-accessibility-scanner"]}'
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
For VS Code Insiders:
|
|
51
|
+
```bash
|
|
52
|
+
code-insiders --add-mcp '{"name":"accessibility-scanner","command":"npx","args":["mcp-accessibility-scanner"]}'
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Configuration
|
|
56
|
+
|
|
57
|
+
Here's the Claude Desktop configuration:
|
|
58
|
+
|
|
59
|
+
```json
|
|
60
|
+
{
|
|
61
|
+
"mcpServers": {
|
|
62
|
+
"accessibility-scanner": {
|
|
63
|
+
"command": "npx",
|
|
64
|
+
"args": ["-y", "mcp-accessibility-scanner"]
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Usage
|
|
71
|
+
|
|
72
|
+
The scanner exposes a single tool `scan_accessibility` that accepts:
|
|
73
|
+
|
|
74
|
+
- `url`: The webpage URL to scan (required)
|
|
75
|
+
- `violationsTag`: Array of accessibility violation tags to check (required)
|
|
76
|
+
- `viewport`: Optional object to customize the viewport size
|
|
77
|
+
- `width`: number (default: 1920)
|
|
78
|
+
- `height`: number (default: 1080)
|
|
79
|
+
- `shouldRunInHeadless`: Optional boolean to control headless mode (default: true)
|
|
80
|
+
|
|
81
|
+
**Note: When running a scan, an annotated screenshot highlighting any accessibility violations will be automatically saved to your downloads folder.**
|
|
82
|
+
|
|
83
|
+
Example usage in Claude:
|
|
84
|
+
```
|
|
85
|
+
Could you scan example.com for accessibility issues related to color contrast?
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Advanced example with custom options:
|
|
89
|
+
```
|
|
90
|
+
Could you scan example.com for accessibility issues with a viewport of 1280x720 and show the browser window?
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## Development
|
|
94
|
+
|
|
95
|
+
Clone and set up the project:
|
|
96
|
+
```bash
|
|
97
|
+
git clone https://github.com/JustasMonkev/mcp-accessibility-scanner.git
|
|
98
|
+
cd mcp-accessibility-scanner
|
|
99
|
+
npm install
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Start the TypeScript compiler in watch mode:
|
|
103
|
+
```bash
|
|
104
|
+
npm run watch
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Test the MCP server locally:
|
|
108
|
+
```bash
|
|
109
|
+
npm run inspector
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Docker Development
|
|
113
|
+
|
|
114
|
+
For development using Docker:
|
|
115
|
+
|
|
116
|
+
1. Build the development image:
|
|
117
|
+
```bash
|
|
118
|
+
docker build -t mcp-server-dev .
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
2. Run with volume mounting for live code changes:
|
|
122
|
+
```bash
|
|
123
|
+
docker run -it -v $(pwd):/app -p 3000:3000 -e MCP_PROXY_DEBUG=true mcp-server-dev
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Project Structure
|
|
127
|
+
|
|
128
|
+
```
|
|
129
|
+
├── src/ # Source code
|
|
130
|
+
│ ├── index.ts # MCP server setup and tool definitions
|
|
131
|
+
│ └── scanner.ts # Core scanning functionality
|
|
132
|
+
├── build/ # Compiled JavaScript output
|
|
133
|
+
├── Dockerfile # Docker configuration for containerized setup
|
|
134
|
+
├── package.json # Project configuration and dependencies
|
|
135
|
+
└── tsconfig.json # TypeScript configuration
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## License
|
|
139
|
+
|
|
140
|
+
MIT
|
|
141
|
+
|
|
@@ -16,62 +16,62 @@ exports.scanViolations = scanViolations;
|
|
|
16
16
|
const playwright_1 = require("playwright");
|
|
17
17
|
const playwright_2 = require("@axe-core/playwright");
|
|
18
18
|
const node_path_1 = __importDefault(require("node:path"));
|
|
19
|
+
const node_os_1 = __importDefault(require("node:os"));
|
|
19
20
|
function scanViolations(url_1, violationsTag_1) {
|
|
20
21
|
return __awaiter(this, arguments, void 0, function* (url, violationsTag, viewport = { width: 1920, height: 1080 }, shouldRunInHeadless = true) {
|
|
21
22
|
var _a;
|
|
22
23
|
const browser = yield playwright_1.chromium.launch({
|
|
23
24
|
headless: shouldRunInHeadless,
|
|
24
25
|
args: [
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
]
|
|
26
|
+
"--disable-blink-features=AutomationControlled",
|
|
27
|
+
"--disable-dev-shm-usage",
|
|
28
|
+
"--no-sandbox",
|
|
29
|
+
"--disable-setuid-sandbox",
|
|
30
|
+
],
|
|
30
31
|
});
|
|
31
32
|
const context = yield browser.newContext({
|
|
32
33
|
viewport,
|
|
33
|
-
userAgent:
|
|
34
|
+
userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
|
|
34
35
|
});
|
|
35
36
|
const page = yield context.newPage();
|
|
36
37
|
yield page.goto(url);
|
|
37
38
|
yield page.addStyleTag({
|
|
38
|
-
content: `
|
|
39
|
-
.a11y-violation {
|
|
40
|
-
position: relative !important;
|
|
41
|
-
outline: 4px solid #FF4444 !important;
|
|
42
|
-
margin: 2px !important;
|
|
43
|
-
}
|
|
44
|
-
.violation-number {
|
|
45
|
-
position: absolute !important;
|
|
46
|
-
top: -12px !important;
|
|
47
|
-
left: -12px !important;
|
|
48
|
-
background: #FF4444;
|
|
49
|
-
color: white !important;
|
|
50
|
-
width: 25px;
|
|
51
|
-
height: 25px;
|
|
52
|
-
border-radius: 50%;
|
|
53
|
-
display: flex !important;
|
|
54
|
-
align-items: center;
|
|
55
|
-
justify-content: center;
|
|
56
|
-
font-weight: bold;
|
|
57
|
-
font-size: 14px;
|
|
58
|
-
z-index: 10000;
|
|
59
|
-
}
|
|
60
|
-
.a11y-violation-info {
|
|
61
|
-
position: absolute !important;
|
|
62
|
-
background: #333333 !important;
|
|
63
|
-
color: white !important;
|
|
64
|
-
padding: 12px !important;
|
|
65
|
-
border-radius: 4px !important;
|
|
66
|
-
font-size: 14px !important;
|
|
67
|
-
max-width: 300px !important;
|
|
68
|
-
z-index: 9999 !important;
|
|
69
|
-
box-shadow: 0 2px 10px rgba(0,0,0,0.3);
|
|
70
|
-
}
|
|
71
|
-
|
|
39
|
+
content: `
|
|
40
|
+
.a11y-violation {
|
|
41
|
+
position: relative !important;
|
|
42
|
+
outline: 4px solid #FF4444 !important;
|
|
43
|
+
margin: 2px !important;
|
|
44
|
+
}
|
|
45
|
+
.violation-number {
|
|
46
|
+
position: absolute !important;
|
|
47
|
+
top: -12px !important;
|
|
48
|
+
left: -12px !important;
|
|
49
|
+
background: #FF4444;
|
|
50
|
+
color: white !important;
|
|
51
|
+
width: 25px;
|
|
52
|
+
height: 25px;
|
|
53
|
+
border-radius: 50%;
|
|
54
|
+
display: flex !important;
|
|
55
|
+
align-items: center;
|
|
56
|
+
justify-content: center;
|
|
57
|
+
font-weight: bold;
|
|
58
|
+
font-size: 14px;
|
|
59
|
+
z-index: 10000;
|
|
60
|
+
}
|
|
61
|
+
.a11y-violation-info {
|
|
62
|
+
position: absolute !important;
|
|
63
|
+
background: #333333 !important;
|
|
64
|
+
color: white !important;
|
|
65
|
+
padding: 12px !important;
|
|
66
|
+
border-radius: 4px !important;
|
|
67
|
+
font-size: 14px !important;
|
|
68
|
+
max-width: 300px !important;
|
|
69
|
+
z-index: 9999 !important;
|
|
70
|
+
box-shadow: 0 2px 10px rgba(0,0,0,0.3);
|
|
71
|
+
}
|
|
72
|
+
`,
|
|
72
73
|
});
|
|
73
|
-
const axe = new playwright_2.AxeBuilder({ page })
|
|
74
|
-
.withTags(violationsTag);
|
|
74
|
+
const axe = new playwright_2.AxeBuilder({ page }).withTags(violationsTag);
|
|
75
75
|
const results = yield axe.analyze();
|
|
76
76
|
let violationCounter = 1;
|
|
77
77
|
for (const violation of results.violations) {
|
|
@@ -79,28 +79,28 @@ function scanViolations(url_1, violationsTag_1) {
|
|
|
79
79
|
try {
|
|
80
80
|
const targetSelector = node.target[0];
|
|
81
81
|
const selector = Array.isArray(targetSelector)
|
|
82
|
-
? targetSelector.join(
|
|
82
|
+
? targetSelector.join(" ")
|
|
83
83
|
: targetSelector;
|
|
84
84
|
yield page.evaluate(({ selector, violationData, counter }) => {
|
|
85
85
|
const elements = document.querySelectorAll(selector);
|
|
86
|
-
elements.forEach(element => {
|
|
86
|
+
elements.forEach((element) => {
|
|
87
87
|
// Create number badge directly on the element
|
|
88
|
-
const numberBadge = document.createElement(
|
|
89
|
-
numberBadge.className =
|
|
88
|
+
const numberBadge = document.createElement("div");
|
|
89
|
+
numberBadge.className = "violation-number";
|
|
90
90
|
numberBadge.textContent = counter.toString();
|
|
91
91
|
// Add violation styling
|
|
92
|
-
element.classList.add(
|
|
92
|
+
element.classList.add("a11y-violation");
|
|
93
93
|
element.appendChild(numberBadge);
|
|
94
94
|
// Create info box
|
|
95
|
-
const listItem = document.createElement(
|
|
96
|
-
listItem.style.marginBottom =
|
|
97
|
-
listItem.innerHTML = `
|
|
98
|
-
<div style="color: #FF4444; font-weight: bold;">
|
|
99
|
-
Violation #${counter}: ${violationData.impact.toUpperCase()}
|
|
100
|
-
</div>
|
|
101
|
-
<div style="margin: 5px 0; font-size: 14px;">
|
|
102
|
-
${violationData.description}
|
|
103
|
-
</div>
|
|
95
|
+
const listItem = document.createElement("div");
|
|
96
|
+
listItem.style.marginBottom = "15px";
|
|
97
|
+
listItem.innerHTML = `
|
|
98
|
+
<div style="color: #FF4444; font-weight: bold;">
|
|
99
|
+
Violation #${counter}: ${violationData.impact.toUpperCase()}
|
|
100
|
+
</div>
|
|
101
|
+
<div style="margin: 5px 0; font-size: 14px;">
|
|
102
|
+
${violationData.description}
|
|
103
|
+
</div>
|
|
104
104
|
`;
|
|
105
105
|
// Position info box relative to element
|
|
106
106
|
document.body.appendChild(listItem);
|
|
@@ -112,9 +112,9 @@ function scanViolations(url_1, violationsTag_1) {
|
|
|
112
112
|
selector: selector,
|
|
113
113
|
violationData: {
|
|
114
114
|
impact: violation.impact,
|
|
115
|
-
description: violation.description
|
|
115
|
+
description: violation.description,
|
|
116
116
|
},
|
|
117
|
-
counter: violationCounter
|
|
117
|
+
counter: violationCounter,
|
|
118
118
|
});
|
|
119
119
|
violationCounter++;
|
|
120
120
|
}
|
|
@@ -132,16 +132,16 @@ function scanViolations(url_1, violationsTag_1) {
|
|
|
132
132
|
element: node.target[0],
|
|
133
133
|
impactLevel: violation.impact,
|
|
134
134
|
description: violation.description,
|
|
135
|
-
wcagCriteria: (_a = violation.tags) === null || _a === void 0 ? void 0 : _a.join(
|
|
135
|
+
wcagCriteria: (_a = violation.tags) === null || _a === void 0 ? void 0 : _a.join(", "),
|
|
136
136
|
});
|
|
137
137
|
}
|
|
138
138
|
}
|
|
139
|
-
const filePath = node_path_1.default.join(node_path_1.default.join(
|
|
139
|
+
const filePath = node_path_1.default.join(node_path_1.default.join(node_os_1.default.homedir(), "Downloads"), `a11y-report-${Date.now()}.png`);
|
|
140
140
|
const screenshot = yield page.screenshot({
|
|
141
141
|
path: filePath,
|
|
142
142
|
fullPage: true,
|
|
143
143
|
});
|
|
144
|
-
const base64Screenshot = screenshot.toString(
|
|
144
|
+
const base64Screenshot = screenshot.toString("base64");
|
|
145
145
|
yield browser.close();
|
|
146
146
|
return { report, base64Screenshot };
|
|
147
147
|
});
|
package/build/index.js
CHANGED
|
@@ -14,31 +14,33 @@ const accessibilityChecker_1 = require("./accessibilityChecker");
|
|
|
14
14
|
const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
|
|
15
15
|
const server = new mcp_js_1.McpServer({
|
|
16
16
|
name: "Accessibility Information",
|
|
17
|
-
version: "1.0.0"
|
|
17
|
+
version: "1.0.0",
|
|
18
18
|
});
|
|
19
19
|
server.tool("scan_accessibility", {
|
|
20
20
|
url: zod_1.z.string().url(),
|
|
21
21
|
violationsTag: zod_1.z.array(zod_1.z.string()),
|
|
22
|
-
viewport: zod_1.z
|
|
22
|
+
viewport: zod_1.z
|
|
23
|
+
.object({
|
|
23
24
|
width: zod_1.z.number().default(1920),
|
|
24
|
-
height: zod_1.z.number().default(1080)
|
|
25
|
-
})
|
|
26
|
-
|
|
25
|
+
height: zod_1.z.number().default(1080),
|
|
26
|
+
})
|
|
27
|
+
.optional(),
|
|
28
|
+
shouldRunInHeadless: zod_1.z.boolean().default(true),
|
|
27
29
|
}, (_a) => __awaiter(void 0, [_a], void 0, function* ({ url, violationsTag, viewport, shouldRunInHeadless }) {
|
|
28
30
|
const { report, base64Screenshot } = yield (0, accessibilityChecker_1.scanViolations)(url, violationsTag, viewport, shouldRunInHeadless);
|
|
29
31
|
return {
|
|
30
32
|
content: [
|
|
31
33
|
{
|
|
32
34
|
type: "text",
|
|
33
|
-
text: JSON.stringify(Object.assign({ message:
|
|
35
|
+
text: JSON.stringify(Object.assign({ message: "The image has been saved to your downloads." }, report), null, 2),
|
|
34
36
|
},
|
|
35
37
|
{
|
|
36
38
|
type: "image",
|
|
37
39
|
data: base64Screenshot,
|
|
38
|
-
mimeType: "image/png"
|
|
39
|
-
}
|
|
40
|
+
mimeType: "image/png",
|
|
41
|
+
},
|
|
40
42
|
],
|
|
41
|
-
isError: false
|
|
43
|
+
isError: false,
|
|
42
44
|
};
|
|
43
45
|
}));
|
|
44
46
|
exports.default = server;
|
package/build/server.js
CHANGED
|
@@ -20,23 +20,23 @@ function main() {
|
|
|
20
20
|
const transport = new stdio_js_1.StdioServerTransport();
|
|
21
21
|
yield index_1.default.connect(transport);
|
|
22
22
|
try {
|
|
23
|
-
console.error(
|
|
24
|
-
console.error(
|
|
23
|
+
console.error("Starting MCP Accessibility checker server...");
|
|
24
|
+
console.error("MCP server connected successfully");
|
|
25
25
|
}
|
|
26
26
|
catch (error) {
|
|
27
|
-
console.error(
|
|
27
|
+
console.error("Error starting server:", error);
|
|
28
28
|
if (error instanceof Error) {
|
|
29
|
-
console.error(
|
|
29
|
+
console.error("Error stack:", error.stack);
|
|
30
30
|
}
|
|
31
31
|
process.exit(1);
|
|
32
32
|
}
|
|
33
33
|
// Handle process events
|
|
34
|
-
process.on(
|
|
35
|
-
console.error(
|
|
34
|
+
process.on("disconnect", () => {
|
|
35
|
+
console.error("Process disconnected");
|
|
36
36
|
process.exit(0);
|
|
37
37
|
});
|
|
38
|
-
process.on(
|
|
39
|
-
console.error(
|
|
38
|
+
process.on("uncaughtException", (error) => {
|
|
39
|
+
console.error("Uncaught exception:", error);
|
|
40
40
|
process.exit(1);
|
|
41
41
|
});
|
|
42
42
|
// Keep the process running
|
|
@@ -44,7 +44,7 @@ function main() {
|
|
|
44
44
|
});
|
|
45
45
|
}
|
|
46
46
|
// Start the server
|
|
47
|
-
main().catch(error => {
|
|
48
|
-
console.error(
|
|
47
|
+
main().catch((error) => {
|
|
48
|
+
console.error("Fatal error:", error);
|
|
49
49
|
process.exit(1);
|
|
50
50
|
});
|
package/package.json
CHANGED
|
@@ -1,53 +1,54 @@
|
|
|
1
|
-
{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "mcp-accessibility-scanner",
|
|
3
|
+
"version": "1.0.8",
|
|
4
|
+
"description": "A Model Context Protocol (MCP) server for performing automated accessibility scans of web pages using Playwright and Axe-core",
|
|
5
|
+
"main": "build/index.js",
|
|
6
|
+
"types": "build/index.d.ts",
|
|
7
|
+
"bin": {
|
|
8
|
+
"mcp-accessibility-scanner": "build/server.js"
|
|
9
|
+
},
|
|
10
|
+
"files": [
|
|
11
|
+
"build/**/*",
|
|
12
|
+
"README.md",
|
|
13
|
+
"LICENSE"
|
|
14
|
+
],
|
|
15
|
+
"scripts": {
|
|
16
|
+
"build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755') && require('fs').chmodSync('build/server.js', '755')\"",
|
|
17
|
+
"prepare": "npm run build",
|
|
18
|
+
"watch": "tsc --watch",
|
|
19
|
+
"inspector": "npx @modelcontextprotocol/inspector build/index.js"
|
|
20
|
+
},
|
|
21
|
+
"dependencies": {
|
|
22
|
+
"@axe-core/playwright": "^4.10.2",
|
|
23
|
+
"@modelcontextprotocol/sdk": "^1.13.0",
|
|
24
|
+
"@playwright/test": "^1.53.1"
|
|
25
|
+
},
|
|
26
|
+
"devDependencies": {
|
|
27
|
+
"@biomejs/biome": "2.0.4",
|
|
28
|
+
"@types/node": "^24.0.3",
|
|
29
|
+
"ts-node": "^10.9.2",
|
|
30
|
+
"typescript": "^5.8.3"
|
|
31
|
+
},
|
|
32
|
+
"keywords": [
|
|
33
|
+
"mcp",
|
|
34
|
+
"accessibility",
|
|
35
|
+
"a11y",
|
|
36
|
+
"wcag",
|
|
37
|
+
"axe-core",
|
|
38
|
+
"playwright",
|
|
39
|
+
"claude",
|
|
40
|
+
"model-context-protocol"
|
|
41
|
+
],
|
|
42
|
+
"author": "",
|
|
43
|
+
"license": "MIT",
|
|
44
|
+
"repository": {
|
|
45
|
+
"type": "git",
|
|
46
|
+
"url": "git+https://github.com/JustasMonkev/mcp-accessibility-scanner.git"
|
|
47
|
+
},
|
|
48
|
+
"engines": {
|
|
49
|
+
"node": ">=16.0.0"
|
|
50
|
+
},
|
|
51
|
+
"publishConfig": {
|
|
52
|
+
"access": "public"
|
|
53
|
+
}
|
|
54
|
+
}
|