mcp-a11y-learning-guide

This MCP server acts as a guided learning assistant for web accessibility (WCAG). It does not provide in-depth explanations itself; instead, it helps learners by pointing them to official WCAG sources and related Understanding/Techniques pages, prioritizing must-read and recommended materials. The server exposes a small set of tools: search_accessibility_topic to find official documents on a given topic, list_available_topics to see what topics it can guide you to, and get_wcag_criterion to retrieve details about a specific WCAG criterion (for example 2.4.4). To use it, initialize the server via your MCP runtime, then invoke these tools to assemble a learning path that references only officially sanctioned sources. When interacting with learners, start by instructing them to use the a11y-learning-guide tools, for example: “a11y-learning-guide を使用して学習の手伝いをして” or “get_wcag_criterion 2.4.4 を教えて” to fetch focused information from the official docs.

Prerequisites: Node.js and npm installed on your system.

1. Clone the repository: git clone https://github.com/burnworks/mcp-a11y-learning-guide.git

2. Install dependencies: cd mcp-a11y-learning-guide npm install

3. Build the project (produces dist/index.js): npm run build

4. Run the MCP server (example): node dist/index.js // or use your preferred MCP runner to load the produced server file

5. If you need to adjust configuration, edit the environment or startup script as needed and restart the server.

Note: The README describes using Claude Desktop configuration for triggering the server; the essential runtime is node dist/index.js with the mappings and supported tools already built in.

Tips and common considerations:

• The server relies on mappings to limit responses to officially sourced WCAG content. Do not expect the AI to provide non-official explanations.
• After adding or editing mappings, restart the MCP server to reload the cache.
• The allowed domains for sources are explicitly defined in the project; external domains outside the approved list will be ignored.
• If you see incomplete responses, verify that you are invoking the tools in the recommended order (start with a11y-learning-guide usage prompt, then query specific criteria or topics).
• The CLI tools exposed include: search_accessibility_topic (with query and priority_filter), list_available_topics, and get_wcag_criterion (with criterion_id).
• For CLI/IDE workflows, ensure the dist/index.js path is correct in your startup command, especially if using Windows paths in config files.
• The provided npm package name (for reference) is mcp-a11y-learning-guide.