Provides app bundle size analysis and optimization recommendations for Android platform builds.
Supports Dart code analysis, validation against official documentation, and helps troubleshoot common Dart-specific issues in Flutter applications.
Offers Docker support for containerized deployment of the Flutter MCP service.
Provides advanced Flutter development tools including code analysis, widget validation, architecture suggestions, performance optimization, test generation, and documentation search integration.
Offers integration with the GetX state management package, including support for generating clean architecture with GetX as a state management option.
Supports app bundle size analysis and optimization recommendations for iOS platform builds.
Provides npm package installation and command support for managing the Flutter MCP service.
Supports right-to-left (RTL) layout functionality when generating localization configurations for Flutter applications.
Utilizes SQLite for intelligent caching of Flutter documentation and analysis results.
Flutter MCP Service v2.0
Advanced Flutter development tools via Model Context Protocol (MCP) with intelligent caching, token management, and official documentation integration.
🚀 Quick Start
Installation
Integration with Claude Desktop / Cursor
Add to your MCP configuration file:
📋 Complete Tool List & Commands
🆕 Unified Tools (v2.0)
1. flutter_status
Check service health and cache statistics.
2. flutter_search
Universal search across Flutter/Dart documentation, packages, and examples.
Parameters:
query
(required): Search termlimit
(optional): Max results (default: 10)maxTokens
(optional): Response size limit (default: 4000)
3. flutter_analyze
Smart Flutter documentation fetcher and code analyzer.
Parameters:
identifier
(required): Widget/class name or packagecode
(optional): Code to analyzetopic
(optional): "all", "docs", "analysis", "examples" (default: "all")maxTokens
(optional): Response size limitincludeExamples
(optional): Include code examples (default: true)includeAnalysis
(optional): Include code analysis (default: true)
🔧 Legacy Tools (Backward Compatible)
4. analyze_widget
Analyze Flutter widget code for best practices, performance, and accessibility.
Parameters:
widgetCode
(required): Flutter widget codecheckAccessibility
(optional): Check accessibility (default: true)checkPerformance
(optional): Check performance (default: true)
5. validate_flutter_docs
Validate code against official Flutter documentation.
Parameters:
code
(required): Flutter/Dart codewidgetType
(optional): Specific widget to focus on
6. analyze_pub_package
Analyze packages from pub.dev for quality and compatibility.
Parameters:
packageName
(required): Package name from pub.devcheckDependencies
(optional): Analyze dependencies (default: true)checkScores
(optional): Retrieve pub.dev scores (default: true)
7. suggest_improvements
Get improvement suggestions based on Flutter best practices.
Parameters:
code
(required): Flutter codefocusArea
(optional): "performance", "accessibility", "maintainability", "all"
8. analyze_performance
Analyze Flutter widget tree for performance issues.
Parameters:
widgetTree
(required): Widget tree codecheckRebuildOptimization
(optional): Check rebuilds (default: true)checkMemoryLeaks
(optional): Check memory leaks (default: true)
9. analyze_architecture
Analyze project architecture compliance.
Parameters:
projectStructure
(required): Project directory structurepattern
(optional): "clean", "mvvm", "mvc", "auto"checkDependencies
(optional): Check dependency violations (default: true)
10. analyze_bundle_size
Analyze app bundle size with optimization recommendations.
Parameters:
buildPath
(required): Path to build outputplatform
(optional): "android", "ios", "web", "all"includeAssets
(optional): Include asset analysis (default: true)
11. generate_tests
Generate comprehensive Flutter tests.
Parameters:
widgetCode
(required): Widget codetestType
(optional): "unit", "widget", "integration", "golden", "all"includeAccessibility
(optional): Include accessibility tests (default: true)
12. trace_state
Trace state flow and rebuilds in Flutter widgets.
Parameters:
widgetCode
(required): Widget codetraceRebuildPaths
(optional): Trace rebuilds (default: true)generateVisualization
(optional): Generate visualization (default: true)
13. generate_clean_architecture
Generate Clean Architecture structure.
Parameters:
projectName
(required): Project/feature namefeatures
(required): List of featuresstateManagement
(optional): "riverpod", "bloc", "provider", "getx"includeDI
(optional): Include dependency injection (default: true)
14. generate_l10n
Generate localization setup with ARB files.
Parameters:
languages
(required): Language codes to supporttranslations
(optional): Initial translationsincludeRTL
(optional): Include RTL support (default: true)includePluralization
(optional): Include pluralization (default: true)
15. monitor_performance
Generate performance monitoring setup.
Parameters:
monitoringType
(required): "comprehensive", "balanced", "lightweight"includeNetwork
(optional): Monitor network (default: true)includeMemory
(optional): Monitor memory (default: true)includeAnalytics
(optional): Include analytics (default: true)
16. diagnose_render_issues
Diagnose and fix rendering issues.
Parameters:
widgetCode
(required): Widget code with issueserrorType
(optional): "overflow", "constraint", "layout", "all"includeVisualization
(optional): Include debug visualization (default: true)
17. analyze_test_coverage
Analyze test coverage with recommendations.
Parameters:
coverageData
(required): Coverage data from lcovprojectStructure
(required): Project file structuretargetCoverage
(optional): Target percentage (default: 80)generateReport
(optional): Generate visual report (default: true)
🎯 Usage Examples
Basic Widget Analysis
Package Research
Performance Optimization Workflow
Full Project Analysis
🔧 Development Commands
📊 Features
- Intelligent Caching: SQLite + in-memory cache with TTL
- Token Management: Smart truncation with GPT-3 encoder
- Error Handling: Circuit breaker pattern with retry logic
- Rate Limiting: Respectful API usage (2 req/sec)
- Official Docs Integration: Real-time Flutter/Dart documentation
- Multi-platform: npm, Docker, direct installation
- Health Monitoring: Built-in health checks and statistics
🏗️ Architecture
See docs/ARCHITECTURE.md for detailed architecture documentation.
🤝 Contributing
See docs/DEVELOPMENT.md for development guidelines.
📄 License
MIT License - see LICENSE file for details.
🙏 Acknowledgments
- Flutter team for excellent documentation
- MCP SDK contributors
- Inspired by adamsmaka/flutter-mcp
Made with ❤️ for the Flutter community
This server cannot be installed
Provides advanced Flutter development tools via Model Context Protocol with features including widget analysis, documentation search, performance optimization, and code generation.
Related MCP Servers
- AsecurityAlicenseAqualityFacilitates unified execution and result parsing for various testing frameworks, including Bats, Pytest, Flutter, Jest, and Go, through a Model Context Protocol interface.Last updated -112TypeScriptMIT License
- AsecurityFlicenseAqualityEnables interaction with the Flutter SDK by providing tools to analyze and apply fixes to Dart and Flutter files.Last updated -23JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that connects Flutter apps with AI coding assistants like Cursor, Claude, and Cline, enabling AI-powered analysis of widget trees, navigation, and layout issues.Last updated -62104JavaScriptMIT License
- AsecurityFlicenseAqualityA comprehensive Model Context Protocol server for advanced code analysis that provides tools for syntax analysis, dependency visualization, and AI-assisted development workflow support.Last updated -283Python