English Français العربية

Ranuk Web Accessibility & AST Security Auditor

Official registry Security

Edge MCP Server for live WCAG 2.1 AA accessibility compliance and AST security audits.

Source code Documentation

What can you do with Ranuk Web Accessibility & AST Security Auditor?

  • Scans Python files and notebooks for data accessibility issues
  • Detects missing docstrings, type hints, and accessibility standards
  • Generates reports with actionable insights
  • Integrates with CI/CD pipelines

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http ranuk-web-accessibility-ast-security-aud 'https://audit.ranuk.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ranuk-web-accessibility-ast-security-aud": {
            "type": "http",
            "url": "https://audit.ranuk.dev/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ADA-Audits
  2. 📌 Features
  3. 🚀 Quick Start
  4. 📖 Usage
  5. 🤝 Contributing
  6. 📄 License

ADA-Audits

Automated Data Accessibility Audits for Python projects.

📌 Features

  • Scans Python files and notebooks for data accessibility issues
  • Detects missing docstrings, type hints, and accessibility standards
  • Generates reports with actionable insights
  • Integrates with CI/CD pipelines

🚀 Quick Start

Follow these steps to get started with ADA-Audits:

Step 1: Installation

Using pip:

# Clone the repository
git clone https://github.com/your-org/ada-audits.git
cd ada-audits

# Install in development mode
pip install -e .

Using Poetry:

# Clone the repository
git clone https://github.com/your-org/ada-audits.git
cd ada-audits

# Install dependencies with Poetry
poetry install

# Activate the virtual environment
poetry shell
Step 2: Create Configuration File

Create a .ada-audit.yml file in your project root:

# .ada-audit.yml - Minimal working configuration
targets:
  - src/
  - notebooks/

rules:
  - missing-docstring
  - missing-type-hint
  - accessibility-issue

output:
  format: markdown
  file: audit-report.md
Step 3: Run Your First Audit

Scan a single file:

ada-scan path/to/file.py

Expected output:

✓ Scanning: path/to/file.py
Found 3 issues:
  [WARNING] line 15: Missing docstring for function 'process_data'
  [WARNING] line 23: Missing type hint for parameter 'input_path'
  [ERROR]   line 45: Accessibility issue - missing alt text for image

Scan an entire directory:

ada-scan src/

Expected output:

✓ Scanning directory: src/
Found 12 files to analyze
  src/__init__.py .............. OK
  src/main.py .................. 2 issues
  src/utils.py ................. 5 issues
  src/processors/base.py ....... 1 issue
  src/processors/transform.py .. 4 issues

Summary: 12 issues found across 4 files

Generate a full report:

ada-audit --output report.md

Expected output:

✓ ADA Audit Report Generated
  Output: report.md
  Total files scanned: 12
  Issues found: 15
  Compliance score: 78%

📖 Usage

Command Line Interface
CommandDescription
ada-scan <path>Scan a file or directory for accessibility issues
ada-auditGenerate a full audit report based on configuration
ada-audit --output <file>Generate report with custom output filename
ada-audit --format <fmt>Output format: markdown, json, or html
Configuration Reference

Full configuration options for .ada-audit.yml:

# Paths to scan
targets:
  - src/              # Python source files
  - notebooks/        # Jupyter notebooks
  - tests/            # Test files

# Rules to apply
rules:
  - missing-docstring      # Functions/classes without docstrings
  - missing-type-hint      # Parameters without type annotations
  - accessibility-issue    # Accessibility standard violations

# Output settings
output:
  format: markdown         # Options: markdown, json, html
  file: audit-report.md   # Output filename

# Optional: Exclude patterns
exclude:
  - "**/__pycache__/**"
  - "**/migrations/**"

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/your-feature)
  3. Commit your changes (git commit -m 'feat: add new rule [ranukita:xxxxx]')
  4. Push to the branch (git push origin feature/your-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Frequently asked questions

What is Ranuk Web Accessibility & AST Security Auditor?

Edge MCP Server for live WCAG 2.1 AA accessibility compliance and AST security audits.

How do I install Ranuk Web Accessibility & AST Security Auditor?

It runs as a remote server. In Claude Code: claude mcp add --transport http ranuk-web-accessibility-ast-security-aud 'https://audit.ranuk.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Ranuk Web Accessibility & AST Security Auditor need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Ranuk Web Accessibility & AST Security Auditor open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Ranuk Web Accessibility & AST Security Auditor?

It is published by RanuK12. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.