Mobile MCP Validator

🛡️ モバイルMCPバリデータ

AIの「雰囲気コーディング」を阻止 — 規律あるモバイル開発を強制する

このツールは、モバイル開発におけるAIコーディングの散漫さを解消し、規律あるコーディングを強制するためのMCPサーバーです。

🚀 クイックスタート

1. リポジトリをクローンする

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

2. Cursorに追加する

~/.cursor/mcp.jsonに以下を追加します。

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

3. Cursorを再起動する

以上で完了です。MCPがあなたのコードベースを保護し始めます。

✨ 主な機能

🎯 タスク計画 (無計画な変更を防止)

AIはコーディング前に必ずタスク計画を作成する必要があります。

ユーザー: "設定画面を追加する"

AI呼び出し: create_task_plan()

→ タスク1: 既存のパターンを分析する
→ タスク2: 設定コントローラーを作成する
→ タスク3: すべてのUI状態を持つ設定画面を構築する
→ タスク4: 検証を実行する
→ タスク5: コード品質を検証する

🚫 エラーブロッキング (修正を強制)

AIがミスを犯した場合、ブロックされます。

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

AIは問題を修正するまで処理を進めることができません。

🔍 破壊的変更検出

既存のコードを変更する前に、AIは現在の状態の「スナップショット」を取得し、変更後に意図しない変更を検出します。クラス、メソッド、またはAPIが誤って削除された場合に警告します。

🎨 UI/UXのベストプラクティス

以下のUI/UXのベストプラクティスに従うようにAIを強制します。

• デザイン原則 — 視覚的な階層、スペーシング、一貫性
• カラーシステム — パレット、ダークモード、コントラスト
• タイポグラフィ — フォントスケール、ウェイト、読みやすさ
• 8ptグリッドシステム — 一貫したスペーシング
• アニメーション — タイミング、イージング、マイクロインタラクション
• アクセシビリティ — タッチターゲット、スクリーンリーダー、コントラスト

📱 サポートされるプラットフォーム

すべてのモバイル開発フレームワークで動作します。

🛠️ ツール

タスク計画

コード品質

破壊的変更

プラットフォーム分析

🎨 UI/UXガイドライン

MCPには、美しいアプリを構築するための包括的なリソースが含まれています。

⚙️ 設定

プロジェクトにflutter_guardian.yamlを作成します。

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

🔒 プリコミットフック

コミット前にコードを検証します。

dart run mobile_mcp_validator:pre_commit --install

👨‍💻 作者について

Emran Shiekh Ahmad

SolarEdgeの上級ソフトウェアエンジニア

🚀 8年以上のモバイル開発経験

📱 Flutter、iOS、Androidに特化

💡 コード品質、アーキテクチャ、開発者体験に情熱を持つ

🎯 AIアシスタントの「雰囲気コーディング」問題を解決するためにこのMCPを構築

このプロジェクトを作成した理由

「数年間モバイルアプリを構築してきて、アマチュアとプロのコードの違いは機能だけでなく、規律にあることを学びました。コーディング前の計画。一貫したパターン。クリーンなアーキテクチャ。美しくアクセシブルなUI。

AIアシスタントがコードを手伝い始めたとき、彼らはしばしばこの規律を欠いていることに気づきました。彼らは計画なしにコーディングに飛び込み、巨大なファイルを作成し、パターンを無視し、一貫性のないUIを作成します。

Mobile MCP Validatorは私の解決策です。それは上級開発者の規律をAI支援コーディングに持ち込みます。私が始めたときに欲しかった守護者 — そして今は誰でも利用できます。」

— Emran Shiekh Ahmad

🌟 このプロジェクトをスターする

このプロジェクトが役に立った場合は、⭐ このリポジトリをスターしてください — 他の人がこのプロジェクトを発見するのに役立ちます！

📄 ライセンス

MITライセンス — 詳細はLICENSEを参照してください。 Copyright © 2025 Emran Shiekh Ahmad