🧠 Flutter MCPilot(MCP服务器)-用于Flutter的AI驱动模块化命令处理器
Flutter MCP服务器 它不仅仅是另一个AI代码工具。\ 它是一个 项目意识, 模块化,以及 教育的 专门为Flutter构建的后端助手。
Flutter MCP服务器它不是经典的Copilot。\ 它了解你的项目,记住以前的决定,根据它塑造你的新决定。在编写代码时教你。
______________________________________________________________________
🚀 为什么选择Flutter MCP服务器?/Neden Flutter MCP服务器?
当 复制品代理 有助于完成线条, Flutter MCP服务器 构建完整的功能。\ 它分析您的架构,跟踪您过去的偏好,并生成具有合理解释的可维护输出。
复制品代理提供行建议。\ Flutter MCP服务器 它可以创建整体解决方案,阅读您的项目架构,并根据您过去的偏好优化未来的输出。
______________________________________________________________________
🆚 Copilot代理与Flutter MCP服务器
| 功能/Özellik | 副驾驶代理 | Flutter MCP服务器 |
|---|---|---|
| 内联代码建议/Kod-tahmini | ✅ | 🚫 非基于建议 |
| 模块化命令处理器 | ❌ | ✅ 干净的处理程序驱动架构 |
| 项目记忆/过去决策分析❌ | ✅ 从历史中学习。 | |
| SDK和文档集成 | ❌ | ✅ Flutter SDK+Flutter.dev分析 |
| 测试和重构工具 | ❌ | ✅ blocTest,GoRouter迁移,复杂性 |
| 教育笔记/Öğretici notlar | ❌ | ✅ 解释为什么,而不仅仅是什么 |
| dryRun&日志记录 | ❌ | ✅ 安全预览+日志记录 |
______________________________________________________________________
📦 它是做什么的/奈勒·雅帕?
🏗️ 模块化指挥架构
- 7名专业处理人员 针对不同的发展方面
- 动态命令发现 基于类别的组织
- 集中错误处理 和命令路由
- 可扩展设计 便于添加新的命令类别
🛠️ 代码生成与分析
- ✅ 飞镖课程 -JSON可序列化,赤道支持
- ✅ 立体主义一代 -带状态管理的BLoC模式
- ✅ API 服务 -具有错误处理功能的HTTP客户端
- ✅ 材料设计3主题 -完整的主题模块
- 🧪 测试生成 -基于blocTest的单元测试
- 🔍 代码审查 -质量分析和重构建议
🔄 项目迁移与优化
- 🔄 导航员→ GoRouter 迁移
- 📁 特征复杂性分析 -建筑评分
- 🚀 插件创建 -Flutter插件样板
- 📱 屏幕生成 -提示创建小部件UI
📚 文件和包装管理
- 📚 Flutter文档搜索 -flutter.dev集成
- 📦 pub.dev包发现 -智能套餐推荐
- 🔍 包装分析 -兼容性和安全检查
🛡️ 开发安全与学习
- 🧪 dryRun模式 -执行前的安全预览
- 🧠 教育笔记 -了解为什么,而不仅仅是什么
- 📊 指令遥控 -绩效跟踪和洞察
- 🔒 安全文件操作 -路径遍历保护
🌐 多接口支持
- REST API -传统HTTP端点集成
- JSON-RPC 2.0 -AI客户端兼容协议
- MCP协议 -模型上下文协议合规性
> 使用预览模式进行安全操作
______________________________________________________________________
🎯 可用命令 / Available Commands
🌍 环境命令
checkFlutterVersion-Flutter SDK版本验证和项目兼容性
🛠️ 代码生成命令
generateDartClass-使用JSON序列化和Equatable创建Dart类generateCubitBoilerplate-使用状态管理生成BLoC模式CubitgenerateApiService-创建具有错误处理功能的HTTP API服务类generateThemeModule-生成材料设计3个主题模块
🔍 分析命令
reviewCode-全面的代码质量分析和重构建议analyzeFeatureComplexity-项目架构和复杂性评分
🧪 测试命令
generateTestsForCubit-为Cubits创建基于blocTest的单元测试
📚 文档命令
searchFlutterDocs-使用类别过滤搜索flutter.dev文档
📦 程序包命令
searchPubDevPackages-通过智能过滤在pub.dev上发现软件包analyzePackage-详细的包分析和兼容性检查
📁 文件系统命令
writeToFile-具有路径遍历保护的安全文件操作migrateNavigationSystem-将导航器转换为GoRouter模式generateScreen-根据自然语言提示创建Flutter屏幕createFlutterPlugin-生成Flutter插件样板loadProjectPreferences-加载并分析项目配置
______________________________________________________________________
📂 项目结构 / Project Structure
flutter-mcp-server/
├── Controllers/ # API endpoints / API uçları
│ └── CommandController.cs # Simplified with handler manager integration
├── Services/ # Code, test, review services / Servis katmanları
│ ├── CodeGenerator.cs # Dart class, Cubit, API service generation
│ ├── FlutterVersionChecker.cs # SDK version validation
│ ├── CodeReviewService.cs # Code quality analysis
│ ├── FlutterDocService.cs # flutter.dev documentation search
│ └── PubDevService.cs # pub.dev package discovery
├── Handlers/ # Modular command handlers / Komut işleyiciler
│ ├── ICommandHandler.cs # Base interface for all handlers
│ ├── CommandHandlerManager.cs # Central command routing
│ ├── EnvironmentCommandHandler.cs # Flutter SDK operations
│ ├── CodeGenerationCommandHandler.cs # Code generation commands
│ ├── AnalysisCommandHandler.cs # Code review and complexity
│ ├── TestingCommandHandler.cs # Test generation
│ ├── DocumentationCommandHandler.cs # Flutter docs search
│ ├── PackageCommandHandler.cs # pub.dev operations
│ └── FileSystemCommandHandler.cs # File operations and migrations
├── Models/ # Command models / Veri modelleri
│ └── McpCommand.cs # MCP protocol command structure
├── Config/ # Configuration templates / Yapılandırma şablonları
│ ├── mcp-capabilities.json # MCP protocol capabilities
│ ├── dart-class-template.json # Dart class generation templates
│ ├── cubit-template.json # Cubit state management templates
│ ├── api-service-template.json # API service templates
│ └── theme-template.json # Material Design 3 theme templates
└── Examples/ # Command examples / Komut örnekleri
├── rest-api/ # REST API examples
├── json-rpc/ # JSON-RPC 2.0 examples
├── mcp-protocol/ # MCP protocol examples
└── integration/ # Integration test scenarios______________________________________________________________________
✅ Getting Started / 开始
git clone https://github.com/your-org/flutter-mcp-server.git
cd flutter-mcp-server
dotnet run要求。净值7+\ 需要 .NET 7+
______________________________________________________________________
🧪 试运行示例/试运行Örneği
{
"command": "generateTestsForCubit",
"params": {
"path": "lib/feature/cart/cart_cubit.dart"
},
"dryRun": true
}您将在不写入文件的情况下获得安全的预览。
您将在不写入文件的情况下获得示例输出。
______________________________________________________________________
🧠 编码时学习/Learn as You Build
🧠copyWith()提高了状态不变性。\ 📘copyWith()使用, Cubit更新提供更安全的过渡.
______________________________________________________________________
📈 日志和遥测/Loglama ve Telemetri
每次执行都会保存到 project_log.txt.\ 所有命令 project_log.txt 在注册:
- ⏱️ 预计节省的时间/Zaman tasarrufu
- 🎯 Style Score / 风格评分
- 📘 学习笔记 / Learning Notes
- ⚠️ 复杂度评分(Complexity Score)
- 🔍 代码评论提示 / 代码气味警告
______________________________________________________________________
📄 许可证/Lisans
MIT许可证-可免费用于商业和个人项目。\ MIT许可证 - 商业和个人使用免费。
______________________________________________________________________
✨ 路线图 / Roadmap
🎯 第一阶段:核心功能完成
- \[x\]✅ Flutter版本检查器
- \[x\]✅ 代码审查和重构服务
- \[x\]✅ 机柜测试生成器
- \[x\]✅ 导航迁移(Navigator→ GoRouter)
- \[x\]✅ 屏幕生成器(小部件提示)
- \[x\]✅ Flutter插件创建器
- \[x\]✅ 项目复杂性分析器
- \[x\]✅ 支持YAML/JSON的配置服务
- \[x\]✅ 具有干运行模式的安全文件写入器
- \[ \] 🔄 FlutterDocService(flutter.dev集成)
- \[ \] 🔄 PubDevService(pub.dev包分析)
- \[ \] 🔄 MCP协议层(符合JSON-RPC 2.0标准)
🚀 第二阶段:高级人工智能集成
- \[ \] 🧠 AI提示解析器端点
> POST /resolve-prompt -自然语言到命令映射
- \[ \] 🔍 命令遥测仪表板
> 支持Prometheus/Grafana的实时指标
- \[ \] 🧩 动态命令注册
> 可扩展命令的插件架构
- \[ \] 🔄 命令撤销/回放API
> POST /commands/replay 具有完整的命令历史记录
🛠️ 第三阶段:开发者体验
- \[ \] 🧪 增强模拟模式
> 干运行后的先进测试数据注入
- \[ \] 📁 文件系统快照API
> 跟踪所有MCP生成的文件更改
- \[ \] 💬 自然语言反馈收集器
> 从用户反馈中学习人工智能
- \[ \] 🛡️ 命令角色授权
> 管理员/开发人员/测试用户基于角色的访问
🌐 第四阶段:平台扩展
- \[ \] 🌍 多语言指令翻译
> /instructions?lang=tr 用于本地化AI提示
- \[ \] 🔌 VS代码扩展
> 直接集成IDE
- \[ \] 📱 Dart CLI SDK
> CI/CD命令行界面
- \[ \] 🌐 网络游乐场
> 基于浏览器的测试环境
- \[ \] 📝 可定制的提示配置文件
> 用户定义的AI行为模板
📊 当前状态
✅ 9/12核心服务 实施\ ✅ REST API 功能齐全(端口5171)\ ✅ Swagger用户界面 可在 /swagger\ ⏳ MCP协议 层正在进行中\ 📈 约75%完成 第一阶段
🎯 下一个里程碑
- 完成MCP协议集成 -AI自动发现
- 实现FlutterDoc和PubDev服务 -外部API集成
- 启动遥测仪表板 -生产监控
- Beta VS代码扩展 -开发人员采用
______________________________________________________________________
🙌 贡献 / Contribute
欢迎拉取请求。对于重大更改,请打开一个问题。\ 您可以发送 Pull Request。对于重大变化,您只需发布一个问题。
______________________________________________________________________
🔍 关键字 / 关键词
flutter mcp, ai codegen, flutter bloc test, navigation refactor, flutter sdk analyzer, project-aware ai, command processor, code generator flutter
______________________________________________________________________
🚀 技术支持。NET•专为Flutter设计•专为教学而构建
