Skip to main content

mcp-axe

PyPI version

🧪 mcp-axe: Accessibility Testing Plugin using Axe-core

mcp-axe is an MCP-compatible plugin for automated accessibility scanning using Deque's axe-core. It supports both Selenium and Playwright engines and provides a CLI and FastAPI interface for scanning URLs, raw HTML content, and batches.

📦 Installation

PyPI

You could use mcp-axe from pypi package https://pypi.org/project/mcp-axe/

API Usage

Clone this repo and install in editable mode:

#optional
#git clone https://github.com/yourname/mcp-axe.git
#cd mcp-axe

python3 -m venv .venv && source .venv/bin/activate
pip install -e .

MCP Client

If you install direct from pip The configure Claude as below

{
  "mcpServers": {
    "axe-a11y": {
      "command": "python3",
      "args": ["-m", "mcp_axe"],
      "cwd": "."
    }
  }
}

If you are on development mode then configure claude as below

{
  "mcpServers": {
    "axe-a11y": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "mcp_axe"],
      "cwd": "/path/to/mcp-axe"
    }
  }
}

CLI Usage

Scan a URL

mcp-axe scan-url https://broken-workshop.dequelabs.com --engine selenium --no-headless --save --output-json --output-html

Scan a local HTML file

mcp-axe scan-html path/to/your/file.html --browser chrome --no-headless --save --output-json --output-html

Batch scan multiple URLs:

mcp-axe batch-scan "https://broken-workshop.dequelabs.com,https://google.com" --engine selenium --browser chrome --headless --save --output-json

Summarize a saved report:

mcp-axe summarize report_selenium_chrome.json --output-json --save

Metadata

Release files for mcp-axe 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-axe 0.1.6
File Size Uploaded Provenance Actions
mcp_axe-0.1.6.tar.gz 8.3 kB Without provenance Details for mcp_axe-0.1.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-axe 0.1.6
File Interpreter ABI Platform Actions
mcp_axe-0.1.6-py3-none-any.whl Python 3 none any Details for mcp_axe-0.1.6-py3-none-any.whl

Total release size: 15.2 kB

Release files / mcp_axe-0.1.6.tar.gz

Download URL mcp_axe-0.1.6.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
0e0d76561ff9f971f71db9631c6d0ecdeeb86cd1b190aa043aace090256ee220
BLAKE2b-256 checksum
How to use checksums
064dddbd73b22cafb40e257d64b99dd890abd98b591b3da58604b3ab4b6d5c05
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.0

Release files / mcp_axe-0.1.6-py3-none-any.whl

Download URL mcp_axe-0.1.6-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9eea245d28272dc82f708244a4b99aaef95c251616a1eb378c84f7c499094abc
BLAKE2b-256 checksum
How to use checksums
0a4c67d0f881f3e72d975ee2b9cde4022e25b28d266e7e1a70fc96e769606e4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.0

Security for mcp-axe 0.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.6 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page