mobile-mcp-validator - 移动开发MCP验证工具，解决AI助手编码问题，支持多平台

探索

Mobile MCP Validator

移动开发MCP验证工具，通过强制任务规划、代码质量检查和UI/UX规范执行，解决AI助手'随意编码'问题，支持Flutter、React Native、iOS和Android平台

开发者工具人工智能聊天机器人 #代码质量检查 #UI/UX规范 #任务规划 #移动开发

评分 : 2分

下载量 : 4.7K

更新时间 : 2025-12-29

打开站点

什么是Mobile MCP Validator?

Mobile MCP Validator是一个专门为移动开发设计的AI助手监管工具。它通过Model Context Protocol (MCP)集成到Cursor IDE中，在AI编写代码时实时验证代码质量，确保AI助手遵循专业的开发规范，而不是随意编写代码。

如何使用Mobile MCP Validator?

安装后，Mobile MCP Validator会自动在后台工作。当AI助手尝试编写或修改移动应用代码时，它会检查代码是否符合预设规则，如文件大小限制、架构分离、UI状态完整性等。如果发现问题，它会阻止AI继续，直到问题被修复。

适用场景

适用于所有使用AI助手进行移动开发的场景，特别是： 1. 使用Cursor IDE进行Flutter、React Native、iOS或Android开发 2. 团队希望保持代码质量和一致性 3. 防止AI助手破坏现有架构 4. 确保UI/UX符合专业标准

主要功能

强制任务规划

要求AI在开始编码前创建详细的任务计划，防止随意修改代码

代码质量验证

自动检查代码质量，包括文件大小、函数复杂度、架构分离等

破坏性变更检测

检测AI是否意外修改了不应更改的代码，防止破坏现有功能

UI/UX最佳实践

内置完整的UI/UX设计指南，确保AI创建的界面专业且一致

多平台支持

支持Flutter、React Native、iOS原生和Android原生开发

阻止式验证

发现严重问题时阻止AI继续编码，直到问题被修复

优势

防止AI随意修改代码，保持代码库的稳定性

强制执行专业开发规范，提升代码质量

减少代码审查时间，AI生成的代码更符合团队标准

支持多种移动开发框架，适用范围广

内置UI/UX指南，确保界面设计的一致性

局限性

需要配置和集成到开发环境中

对于非常规项目可能需要调整验证规则

可能增加AI编码的初始规划时间

如何使用

克隆仓库

将Mobile MCP Validator项目克隆到本地

配置Cursor IDE

编辑Cursor的MCP配置文件，添加Mobile MCP Validator服务器

添加服务器配置

在配置文件中添加Mobile MCP Validator的启动命令

重启Cursor

重启Cursor IDE使配置生效

项目配置（可选）

在项目中创建配置文件来自定义验证规则

使用案例

案例1：添加新功能页面

AI需要添加一个新的用户个人资料页面

案例2：修复现有功能

AI需要修改现有的设置页面

案例3：重构复杂代码

AI需要重构一个过于复杂的组件

常见问题

Mobile MCP Validator会影响编码速度吗？

支持哪些移动开发框架？

如何自定义验证规则？

MCP验证失败会怎样？

需要网络连接吗？

🚀 移动MCP验证器

移动MCP验证器能够阻止AI“随意编码”，助力规范的移动开发。

🚀 快速开始

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: 文件超过300行（当前：425行）",
  "fixSuggestion": "拆分为更小的模块..."
}

AI必须修复问题才能继续。

🔍 变更检测

在修改现有代码之前：

AI会对当前状态进行“快照”
修改后，进行比较以检测意外修改
如果类、方法或API被意外删除，会发出警报

🎨 UI/UX最佳实践

内置全面的指南：

设计原则 — 视觉层次、间距、一致性
颜色系统 — 调色板、暗黑模式、对比度
排版 — 字体大小、粗细、可读性
8pt网格系统 — 一致的间距
动画 — 时间、缓动、微交互
可访问性 — 触摸目标、屏幕阅读器、对比度

📦 安装指南

克隆仓库

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

添加到Cursor

将配置添加到 ~/.cursor/mcp.json 文件：

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

重启Cursor

完成上述步骤后，MCP将开始保护你的代码库。

💻 使用示例

配置 `flutter_guardian.yaml`

在你的项目中创建 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

📚 详细文档

🎯 解决的问题

在经历了8年的移动开发后，我发现AI编码助手存在一个反复出现的问题：

“随意编码” — AI编写的代码零散、缺乏规划，会破坏现有代码，忽视模式，并且生成的UI显得业余。

这种情况是否似曾相识？AI存在以下问题：

❌ 无计划地直接开始编码
❌ 修改不应修改的内容
❌ 忽视你的架构模式
❌ 创建不一致、不专业的UI
❌ 忘记处理加载、错误和空状态
❌ 生成的文件超过500行

我开发了移动MCP验证器来解决这个问题。

💡 解决方案

移动MCP验证器是一个适用于 Cursor IDE 的 MCP（模型上下文协议）服务器，它就像你移动代码库的守护者。

它强制AI做到以下几点：

之前	之后（使用MCP）
直接开始编码	✅ 先创建任务计划
随意进行更改	✅ 验证每一处更改
忽视文件大小限制	✅ 阻止超过300行的文件
忘记UI状态	✅ 要求处理加载/错误/空/成功状态
破坏现有代码	✅ 检测破坏性更改
生成丑陋的UI	✅ 遵循UI/UX最佳实践

📱 支持的平台

该工具适用于所有移动开发框架：

平台	语言	代码检查集成
💙 Flutter	Dart	`flutter analyze`
⚛️ React Native	JavaScript、TypeScript	ESLint
🍎 iOS原生	Swift、Objective - C	SwiftLint
🤖 Android原生	Kotlin、Java	ktlint

🛠️ 工具

任务规划

工具	功能
`create_task_plan`	编码前创建清单
`validate_task_completion`	确保所有任务完成
`update_task_status`	跟踪进度

代码质量

工具	功能
`validate_file_size`	阻止超过300行的文件
`validate_function_complexity`	阻止超过50行的函数
`validate_widget_complexity`	阻止超过120行的构建方法
`find_business_logic_in_widgets`	检测业务逻辑是否混入UI

变更检测

工具	功能
`snapshot_ui_state`	变更前捕获状态
`detect_breaking_changes`	查找意外修改
`find_affected_usages`	列出使用某个文件的所有代码

平台分析

工具	功能
`detect_project_framework`	自动检测Flutter/RN/iOS/Android
`run_project_analysis`	自动运行正确的代码检查器
`validate_ios_config`	检查Info.plist、Podfile
`validate_android_config`	检查AndroidManifest、Gradle

🎨 UI/UX指南

MCP包含用于构建精美应用的全面资源：

资源	描述
`uiux://design-principles`	专业UI的核心原则
`uiux://color-system`	颜色、主题、暗黑模式
`uiux://typography`	字体选择和层次结构
`uiux://spacing-layout`	8pt网格系统
`uiux://animations`	动画和微交互
`uiux://accessibility`	包容性设计指南
`uiux://platform-guidelines`	iOS人机界面指南和Material Design
`uiux://common-mistakes`	应避免的反模式

⚙️ 配置

在项目中创建 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

👨‍💻 关于作者


	### 埃姆兰·谢赫·艾哈迈德 SolarEdge高级软件工程师 🚀 8年以上移动开发经验 📱 专注于 Flutter、iOS 和 Android 💡 热衷于代码质量、架构和开发者体验 🎯 开发此MCP以解决AI助手常见的“随意编码”问题

开发原因

“在多年开发移动应用后，我明白业余代码和专业代码的区别不仅在于功能，更在于规范。编码前进行规划，遵循一致的模式，采用简洁的架构，设计美观、可访问的UI。

当AI助手开始辅助编码时，我发现它们往往缺乏这种规范。它们会无计划地直接开始编码，创建庞大的文件，忽视模式，并且生成不一致的UI。

移动MCP验证器就是我的解决方案。它将资深开发者的规范引入AI辅助编码。这是我入行时希望拥有的守护者 —— 现在它为所有人所用。”

— 埃姆兰·谢赫·艾哈迈德