🛡️ Mobile MCP Validator

Stop AI "Vibe Coding" — Enforce Disciplined Mobile Development

Quick Start • Features • Platforms • Tools • UI/UX • Author

🎯 The Problem I Solved

After 8 years of mobile development, I noticed a recurring issue with AI coding assistants:

"Vibe Coding" — AI agents that write scattered, unplanned code that breaks things, ignores patterns, and produces amateur-looking UIs.

Sound familiar? The AI:

• ❌ Jumps into coding without a plan
• ❌ Changes things that shouldn't be changed
• ❌ Ignores your architecture patterns
• ❌ Creates inconsistent, unprofessional UIs
• ❌ Forgets to handle loading, error, and empty states
• ❌ Produces files that are 500+ lines long

I built Mobile MCP Validator to fix this.

💡 The Solution

Mobile MCP Validator is an MCP (Model Context Protocol) server for Cursor IDE that acts as a guardian for your mobile codebase.

It forces AI agents to:

| Before | After (with MCP) | |--------|------------------| | Jump straight into coding | ✅ Create a task plan first | | Make random changes | ✅ Validate every change | | Ignore file size limits | ✅ Block files over 300 lines | | Forget UI states | ✅ Require loading/error/empty/success | | Break existing code | ✅ Detect breaking changes | | Produce ugly UIs | ✅ Follow UI/UX best practices |

📱 Supported Platforms

Works with ALL mobile development frameworks:

| Platform | Languages | Linter Integration | |----------|-----------|-------------------| | 💙 Flutter | Dart | flutter analyze | | ⚛️ React Native | JavaScript, TypeScript | ESLint | | 🍎 iOS Native | Swift, Objective-C | SwiftLint | | 🤖 Android Native | Kotlin, Java | ktlint |

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/emran1993/mobile-mcp-validator.git
cd mobile-mcp-validator
dart pub get

2. Add to Cursor

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mobile-mcp-validator": {
      "command": "dart",
      "args": ["run", "/path/to/mobile-mcp-validator/bin/mobile_mcp_validator.dart"]
    }
  }
}

3. Restart Cursor

That's it! The MCP is now protecting your codebase.

✨ Features

🎯 Task Planning (No More Random Changes)

The AI must create a plan before coding:

User: "Add a settings screen"

AI calls: create_task_plan()

→ Task 1: Analyze existing patterns
→ Task 2: Create settings controller  
→ Task 3: Build settings screen with all UI states
→ Task 4: Run validation
→ Task 5: Verify code quality

🚫 Blocking Errors (Forces Fixes)

When the AI makes a mistake, it gets blocked:

{
  "success": false,
  "isBlocking": true,
  "message": "BLOCKING: File exceeds 300 lines (found: 425)",
  "fixSuggestion": "Split into smaller modules..."
}

The AI cannot proceed until it fixes the issue.

🔍 Breaking Change Detection

Before modifying existing code:

1. AI takes a "snapshot" of the current state
2. After changes, compares to detect unintended modifications
3. Alerts if classes, methods, or APIs were accidentally removed

🎨 UI/UX Best Practices

Comprehensive guidelines built-in:

• Design Principles — Visual hierarchy, spacing, consistency
• Color Systems — Palettes, dark mode, contrast
• Typography — Font scales, weights, readability
• 8pt Grid System — Consistent spacing
• Animations — Timing, easing, micro-interactions
• Accessibility — Touch targets, screen readers, contrast

🛠️ Tools

Task Planning

| Tool | What It Does | |------|--------------| | create_task_plan | Creates checklist before coding | | validate_task_completion | Ensures all tasks are done | | update_task_status | Tracks progress |

Code Quality

| Tool | What It Does | |------|--------------| | validate_file_size | Blocks files over 300 lines | | validate_function_complexity | Blocks functions over 50 lines | | validate_widget_complexity | Blocks build methods over 120 lines | | find_business_logic_in_widgets | Detects logic leaking into UI |

Breaking Changes

| Tool | What It Does | |------|--------------| | snapshot_ui_state | Captures state before changes | | detect_breaking_changes | Finds unintended modifications | | find_affected_usages | Lists all code using a file |

Platform Analysis

| Tool | What It Does | |------|--------------| | detect_project_framework | Auto-detects Flutter/RN/iOS/Android | | run_project_analysis | Runs correct linter automatically | | validate_ios_config | Checks Info.plist, Podfile | | validate_android_config | Checks AndroidManifest, Gradle |

🎨 UI/UX Guidelines

The MCP includes comprehensive resources for building beautiful apps:

| Resource | Description | |----------|-------------| | uiux://design-principles | Core principles for professional UI | | uiux://color-system | Colors, themes, dark mode | | uiux://typography | Font selection and hierarchy | | uiux://spacing-layout | 8pt grid system | | uiux://animations | Motion and micro-interactions | | uiux://accessibility | Inclusive design guidelines | | uiux://platform-guidelines | iOS HIG & Material Design | | uiux://common-mistakes | Anti-patterns to avoid |

⚙️ Configuration

Create flutter_guardian.yaml in your project:

rules:
  max_file_lines: 300
  max_build_method_lines: 120
  max_function_lines: 50

architecture:
  pattern: feature_first
  require_separation: true

testing:
  require_ui_states:
    - loading
    - error
    - empty
    - success

🔒 Pre-commit Hook

Validate code before every commit:

dart run mobile_mcp_validator:pre_commit --install

👨‍💻 About the Author

Emran Shiekh Ahmad Senior Software Engineer @ SolarEdge 🚀 8+ years of mobile development experience 📱 Specializing in Flutter, iOS, and Android 💡 Passionate about code quality, architecture, and developer experience 🎯 Built this MCP to solve the "vibe coding" problem I kept seeing with AI assistants

Why I Built This

"After years of building mobile apps, I've learned that the difference between amateur and professional code isn't just functionality — it's discipline. Planning before coding. Consistent patterns. Clean architecture. Beautiful, accessible UIs.

When AI assistants started helping with code, I noticed they often lacked this discipline. They'd jump into coding without a plan, create massive files, ignore patterns, and produce inconsistent UIs.

Mobile MCP Validator is my solution. It brings the discipline of a senior developer to AI-assisted coding. It's the guardian I wish I had when I started — and now it's available for everyone."

— Emran Shiekh Ahmad

🌟 Star This Project

If you find this useful, please ⭐ star this repository — it helps others discover it!

📄 License

MIT License — see LICENSE for details.

Copyright © 2025 Emran Shiekh Ahmad

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests: dart test
5. Submit a pull request

Built with ❤️ by Emran Shiekh Ahmad
_{Senior Software Engineer @ SolarEdge | 8+ Years Mobile Development}

GitHub • LinkedIn