accessflow-mcp-server 1.0.3 → 1.0.5
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/README.md +94 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# AccessFlow MCP Server
|
|
2
|
+
|
|
3
|
+
A Model Context Protocol (MCP) server that provides intelligent accessibility issue analysis and remediation guidance. This server connects to the AccessFlow platform to help developers identify, prioritize, and fix accessibility issues in their web applications.
|
|
4
|
+
|
|
5
|
+
## 🎯 Purpose
|
|
6
|
+
|
|
7
|
+
The AccessFlow MCP Server enables AI clients (like Copilot) to:
|
|
8
|
+
|
|
9
|
+
- **Identify Priority Issues**: Get the most urgent accessibility issues ordered by severity and impact
|
|
10
|
+
- **Provide Fix Guidance**: Generate detailed remediation instructions with code examples
|
|
11
|
+
- **WCAG Compliance**: Reference specific WCAG guidelines and criteria for each issue
|
|
12
|
+
- **Streamline Workflow**: Integrate accessibility testing directly into your development environment
|
|
13
|
+
|
|
14
|
+
## 🛠️ Available Tools
|
|
15
|
+
|
|
16
|
+
### `getMostUrgentIssues`
|
|
17
|
+
|
|
18
|
+
Retrieves the most critical accessibility issues, prioritized by:
|
|
19
|
+
|
|
20
|
+
1. **Severity**: EXTREME → HIGH → MEDIUM → LOW
|
|
21
|
+
2. **Site Impact**: Number of locations affected across the site
|
|
22
|
+
3. **Page Impact**: Number of occurrences on individual pages
|
|
23
|
+
|
|
24
|
+
**Parameters**: None (uses configured domain)
|
|
25
|
+
|
|
26
|
+
**Returns**: JSON data with structured issue information including severity, WCAG level, occurrence counts, and unique identifiers.
|
|
27
|
+
|
|
28
|
+
### `getIssueRemediation`
|
|
29
|
+
|
|
30
|
+
Provides detailed remediation guidance for a specific accessibility issue.
|
|
31
|
+
|
|
32
|
+
**Parameters**:
|
|
33
|
+
|
|
34
|
+
- `issueDisplayName` (string, required): The unique identifier for the accessibility issue
|
|
35
|
+
|
|
36
|
+
**Returns**: Comprehensive fix guidance including:
|
|
37
|
+
|
|
38
|
+
- Problem summary and WCAG references
|
|
39
|
+
- Current problematic code
|
|
40
|
+
- Suggested code fixes with examples
|
|
41
|
+
- Step-by-step remediation instructions
|
|
42
|
+
- Links to tutorials and additional resources
|
|
43
|
+
|
|
44
|
+
## 📋 Usage
|
|
45
|
+
|
|
46
|
+
### Configuration
|
|
47
|
+
|
|
48
|
+
Add the following configuration to your MCP client (e.g., VS Code Copilot Agent):
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"mcpServers": {
|
|
53
|
+
"flow-mcp": {
|
|
54
|
+
"command": "npx",
|
|
55
|
+
"args": ["-y", "accessflow-mcp-server"],
|
|
56
|
+
"env": {
|
|
57
|
+
"API_KEY": "your-accessflow-api-key",
|
|
58
|
+
"DOMAIN": "https://your-app-domain.com"
|
|
59
|
+
},
|
|
60
|
+
"type": "stdio"
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
#### Configuration Parameters
|
|
67
|
+
|
|
68
|
+
- **`API_KEY`** (required): Your AccessFlow API key for authentication
|
|
69
|
+
- **`DOMAIN`** (required): The domain of your application being analyzed (e.g., `https://example.com`)
|
|
70
|
+
|
|
71
|
+
### 3. Example Usage
|
|
72
|
+
|
|
73
|
+
Once configured, you can interact with the server through your MCP client:
|
|
74
|
+
|
|
75
|
+
**Get Priority Issues:**
|
|
76
|
+
|
|
77
|
+
```text
|
|
78
|
+
"Show me the most urgent accessibility issues for my site"
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
**Get Specific Remediation:**
|
|
82
|
+
|
|
83
|
+
```text
|
|
84
|
+
"Get remediation guidance for issue: Decorative-Content-6d277a13ba"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## � Supported Clients
|
|
88
|
+
|
|
89
|
+
This MCP server works with AI agents in IDEs and other MCP-compatible clients:
|
|
90
|
+
|
|
91
|
+
- **VS Code Copilot**: Integrates with GitHub Copilot in VS Code
|
|
92
|
+
- **Cursor**: Works with Cursor's AI assistant
|
|
93
|
+
- **Claude Desktop**: Direct integration with Claude Desktop app
|
|
94
|
+
- **Other MCP Clients**: Any application supporting the Model Context Protocol
|