Skip to main content
Glama
Impeccable Africa Enhanced MCP Server

Impeccable Africa Enhanced MCP Server

Impeccable Africa Enhanced

Enhanced Impeccable with African design vocabulary, 7 African languages, 5 African accessibility audit dimensions, MCP server with 5 transports, benchmark regression detection, interactive architecture visualization, comprehensive documentation, and enhanced CI/CD.

This is a Mode B (Substantial Enhancement Fork) of the original Impeccable by Paul Bakaus, licensed under Apache-2.0. All improvements are built on top of the upstream project with full attribution.

🌍 African Enhancements

African Design Vocabulary (20 Patterns)

New detector rules in the african category addressing uniquely African digital realities:

Mobile Money (5 rules)

  • african-mobile-money-form β€” Transaction forms with provider branding, local currency, fee transparency, USSD fallback, data cost estimates

  • ussd-flow-pattern β€” Hierarchical USSD menus with breadcrumbs, numeric shortcuts, session timeout handling, SMS fallback

  • sim-toolkit-menu β€” STK menus within 160-char SMS limits, proactive commands, 2G SIM browser compatibility

  • mobile-money-confirmation β€” Recipient masking, local currency, fee breakdown, PIN/biometric prompt, transaction reference

  • agent-cash-in-out β€” Agent verification, float balance, denomination breakdown, receipt generation, SMS confirmation

FinTech (4 rules)

  • african-fintech-dashboard β€” Multi-currency balances (10 African currencies), 12+ mobile money providers, low-data mode, offline caching

  • interbank-transfer-flow β€” NIBSS, PesaLink, BankservAfrica, GHIPSS integration with real-time status and fees

  • wallet-balance-display β€” Consolidated view across mobile money, bank, crypto, cash with currency conversion

  • transaction-history-african β€” Provider badges, currency tags, fee breakdown, USSD reference codes, CSV/PDF export

Healthcare (4 rules)

  • african-healthcare-appointment β€” CHW referrals, SMS/USSD reminders, facility tier selection, NHIF/NHIS integration

  • patient-record-sms β€” Structured SMS formats, 7 local languages, facility codes, opt-out mechanisms

  • community-health-worker-ui β€” Offline-first, icon-heavy navigation, voice input, emergency escalation, background sync

  • telemedicine-low-bandwidth β€” Audio-only mode, async consultation, image compression, 2G/Edge support

Agriculture (4 rules)

  • african-agri-market-prices β€” Mandi/market prices, grade indicators, trends, SMS/USSD access, local languages

  • crop-advisory-sms β€” Crop-specific, calendar-timed, local language, input sourcing, feedback loop

  • farmer-registration-ussd β€” Geo-location, crop types, land size, ID verification, extension service linkage

  • weather-alert-local-language β€” Local languages, indigenous indicators, actionable advice, multi-channel delivery

Government (4 rules)

  • african-gov-service-portal β€” Service catalog, eligibility checker, document checklist, application tracker, multi-channel payment, certificate download, low-data mode, WCAG AA + local language screen readers

  • digital-id-verification β€” NIN, Ghana Card, Huduma Namba, NIDA integration with biometric/OTP/offline fallback

  • benefit-disbursement-ui β€” Program details, payment methods, collection points, status tracking, USSD balance, grievance link, language toggle

  • citizen-feedback-ussd β€” Anonymous reporting, category selection, geo-tagging, reference numbers, SMS follow-up

General Accessibility (7 rules)

  • low-bandwidth-first β€” Critical path < 30KB on 2G/3G, WebP/AVIF, lazy loading, SW cache, data cost estimates

  • offline-capable-indicator β€” Persistent online/offline/syncing status, local mutation queue, 24h+ cache, background sync

  • data-cost-aware β€” Estimated data cost per action, OS data saver respect, compression defaults, Wi-Fi selective sync

  • multi-language-toggle β€” Flag + native name + English, RTL for Hausa Ajami, font fallback for Ge'ez/N'Ko/Tifinagh, 20-40% expansion allowance

  • high-contrast-mode β€” WCAG AAA, forced colors, African screen reader support

  • ussd-accessibility β€” SMS/USSD flow accessibility patterns

  • voice-over-african-languages β€” TTS support for 7 African languages

African Language clarify Support (7 Languages)

The design_clarify MCP tool now supports rewriting ambiguous UX copy in:

Language

Code

Region

Script

Kiswahili

swahili

East Africa

Latin

Luganda

luganda

Uganda

Latin

Amharic

amharic

Ethiopia

Ge'ez

Hausa

hausa

West Africa

Latin/Arabic

Yoruba

yoruba

Nigeria

Latin

Zulu

zulu

Southern Africa

Latin

Xhosa

xhosa

South Africa

Latin

African Accessibility Audit (5 Dimensions + 2 Bonus)

The design_audit MCP tool includes 5 African-specific audit dimensions:

  1. Low-bandwidth β€” Critical path < 30KB, service worker caching

  2. Offline-first β€” Mutation queue, background sync, graceful degradation

  3. High-contrast β€” WCAG AAA, forced colors, African screen reader support

  4. Data-cost β€” Cost estimates, OS data saver respect, selective sync

  5. Multi-language β€” 7 African languages, RTL, font fallback, expansion allowance

  6. USSD Accessibility β€” SMS/USSD flow accessibility patterns (bonus)

  7. Voice-over African Languages β€” TTS for local languages (bonus)

Related MCP server: vibecraft-mcp

πŸš€ MCP Server with 5 Transports

The MCP server now supports 5 transport protocols for broader agent integration:

Transport

Use Case

stdio

Local agents (Claude Code, Codex, Cursor, Hermes)

HTTP POST

REST-style agents, serverless functions

SSE

Streaming responses, long-running operations

Streamable HTTP

Bidirectional streaming over HTTP

WebSocket

Real-time bidirectional communication

8 Design Orchestration Tools

All available across all transports:

  1. design_critique β€” Comprehensive design critique on UI/HTML

  2. design_audit β€” 10-dimension audit (5 standard + 5 African)

  3. design_polish β€” Fix detected slop patterns

  4. design_bolder β€” Strengthen visual hierarchy

  5. design_clarify β€” Rewrite copy in 7 African languages

  6. design_live_start β€” Live mode browser overlay

  7. design_benchmark_run β€” Benchmarks with regression detection

  8. design_viz_generate β€” Interactive architecture visualization

πŸ“Š Benchmark Regression Detection

  • 7 Categories: detector, mcp, live, rule_evaluation, memory, startup, ci_cd

  • 5% Threshold for regression detection

  • SQLite Storage for historical data

  • GitHub Actions Integration with SARIF upload

🎨 Interactive Architecture Visualization

React Flow-based visualization with 8 views:

  • Overview, Crates, Commands, Detectors, MCP, Skills, CI, Data Flow

  • 82+ nodes, exportable as HTML/JSON/Mermaid

πŸ“š Comprehensive Documentation (7 Guides)

  • AFRICAN_DESIGN_GUIDE.md β€” All 20 patterns with examples

  • MCP_GUIDE.md β€” 5 transports, 8 tools, auth, rate limiting, audit logging

  • DESIGN_DOCUMENT.md β€” Architecture decisions

  • PORTFOLIO_CASE_STUDY.md β€” Business impact analysis

  • BEFORE_AFTER.md β€” Visual comparisons

  • RULE_GUIDE.md β€” All 82+ rules documented

  • INTERACTIVE_DOC_TREE.md β€” Navigation

πŸ”’ Enhanced CI/CD Security Pipeline

  • cargo-audit β€” Rust vulnerability scanning

  • cargo-deny β€” Advisories, licenses, bans, sources

  • TruffleHog β€” Secret scanning

  • SBOM Generation β€” CycloneDX format

  • govulncheck β€” Go vulnerability scanning

  • Biome β€” JS/TS linting

  • Mutation Testing β€” cargo-mutants

  • Dependency Review β€” PR dependency analysis

  • Multi-platform builds β€” Linux, macOS, Windows

πŸ›‘οΈ Security Hardening

  • Rate limiting on all HTTP transports (100 req/min HTTP, 50 conn/min SSE/Streamable/WS)

  • Capability-based tokens for tool access

  • Audit logging for all MCP operations

  • Input validation and sanitization

  • Seccomp sandboxing for detector

πŸ“¦ Installation

# From source
git clone https://github.com/nakisisageorge/impeccable-africa-enhanced
cd impeccable-africa-enhanced
cargo build --release -p impeccable

# The binary will be at target/release/impeccable
# Set IMPECCABLE_BIN to use it with the CLI
export IMPECCABLE_BIN=/path/to/impeccable
npx impeccable install

πŸ”— Original Project Attribution

This fork maintains full compatibility with the upstream Impeccable skill ecosystem (30+ agent integrations) while adding African market enhancements.

πŸ“„ License

Apache-2.0 β€” See LICENSE and NOTICE.md for attribution requirements.

🀝 Contributing

See DEVELOP.md for development guidelines.

πŸ“ž Contact

George Nakisisa β€” Senior Software Engineer Β· AI Engineer Β· Cybersecurity

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides coding agents with local tools to inspect project UI inventories, propose and compare visual direction boards, compile versioned design contracts and DTCG tokens, retrieve section-specific blueprints, and audit running interfaces with browser evidence including screenshots, accessibility findings, and overflow measurements.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides deterministic UI/UX intelligence and systems performance auditing tools for AI coding agents, enabling generation of accessible, well-designed React/Tailwind interfaces and elimination of backend anti-patterns like N+1 queries and sequential waterfalls.
      7
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI coding agents to audit rendered web pages for design and UI defects by measuring geometry, styles, contrast and motion in a local browser and judging them against evidence-tiered rules. Findings come back as short, fixable items expressed in the project's own design tokens, while only sanitized numeric measurements leave the machine.
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI coding agents to act like a senior UI/UX team by reading an existing site's design DNA and tokens, proposing distinct art directions and motion mechanics that fit the brief, and validating changes in a live headless Chromium browser. Provides per-element accessibility and performance auditing (WCAG 2.2 contrast, focus, clipping, phone-menu behavior, LCP/CLS) at multiple viewport widths, plus baseline capture, before/after comparison, and one-command rollback for safe redesigns.
      95 npm
      3
      MIT