The Flutter Inspector MCP Server enables AI-powered development by connecting Flutter applications to AI coding assistants via the Model Context Protocol. It provides comprehensive tools for inspection, debugging, and performance monitoring:
- Error Analysis: Retrieve condensed error information with
get_app_errors
- Development Tools: Perform hot reloads and capture screenshots
- Widget Tree Inspection: Get details about layout, parent chains, children summaries, and selected widgets
- Debugging Capabilities: Dump render, layer, semantics, and focus trees; toggle visual aids like baseline paint, layers, and repaint rainbow
- Performance Monitoring: Track widget rebuilds, repaints, and profile socket/HTTP operations
- Environment Control: Override platform, brightness, and time dilation for testing
- Utility Methods: Get VM info, supported protocols, active ports, and discover available extension RPCs
- Integration: Works with AI tools and is registered with Smithery for discoverability
Interfaces with Dart VM Service Protocol to access Flutter/Dart process information, retrieve version details, and monitor various event streams for debugging Flutter applications.
Connects to a Flutter app's debug mode to extract data about widget trees, render trees, layer trees, and semantics, enabling AI tools to provide context-aware assistance for Flutter app development.
MCP Server + Flutter MCP Toolkit
For AI-Powered Development
🔍 Model Context Protocol (MCP) server that connects your Flutter apps with AI coding assistants like Cursor, Claude, Cline, Windsurf, RooCode or any other AI assistant that supports MCP server
📖 Documentation
Note
There is a new experimental package in development from Flutter team which exposes Dart tooling development.
Therefore my current focus is
- to stabilize and polish tools which are useful in development (so it would be more plug & play, for example: it will return not only the errors, but prompt for AI how to work with that error) see more in MCP_RPC_DESCRIPTION.md
- fine-tune process of MCP server tools creation by making it customizable.
Hope it will be useful for you,
Have a nice day!
🎉 v2 released! 🎉
Now Flutter MCP server works without forwarding server and devtools extension. See more in CHANGELOG.md.
⚠️ WARNING
Dump RPC methods (like dump_render_tree
), may cause huge amount of tokens usage or overload context. Therefore now they are disabled by default, but can be enabled via environment variable DUMPS_SUPPORTED=true
.
See more details about environment variables in .env.example.
🚀 Getting Started
- (Experimental) You can try to install MCP server and configure it using your AI Agent. Use the following prompt:
Please install MCP server using this link: https://github.com/Arenukvern/mcp_flutter/blob/main/llm_install.md
- with Cursor: https://www.youtube.com/watch?v=pyDHaI81uts
- with VSCode + Cline: use prompt
Please install MCP server using this link: https://github.com/Arenukvern/mcp_flutter/blob/main/llm_install.md
- Quick Start is available in QUICK_START.md
- Configuration options are available in CONFIGURATION.md
🎯 AI Agent Tools
Error Analysis
get_app_errors
[Resource|Tool] - Retrieves precise and condensed error information from your Flutter app Usage:- Uses only short description of the error. Should filter duplicate errors, to avoid flooding Agent context window with the same errors.
- Uses Error Monitor to capture Dart VM errors. All errors captured in Flutter app, and then available by request from MCP server.
Tested on: ✅ macOS, ✅ iOS Not tested on: 🚧 Android, 🤔 Windows, 🤔 Linux, ❌ Web See issue
Development Tools
view_screenshot
[Resource|Tool] - Captures a screenshots of the running application. Configuration:- Enable with
--images
flag orIMAGES_SUPPORTED=true
environment variable - Will use PNG compression to optimize image size.
- Enable with
get_view_details
[Resource|Tool] - size of screen, pixel ratio. May unlock ability for an Agent to use widget selection.
All tools default to using port 8181 if no port is specified. You can override this by providing a specific port number.
📚 Please see more in MCP_RPC_DESCRIPTION
🔒 Security
Generally, since you use MCP server to connect to Flutter app in Debug Mode, it should be safe to use. However, I still recommend to review how it works in ARCHITECTURE.md, how it can be modified to improve security if needed.
This MCP server is verified by MseeP.ai.
🔧 Troubleshooting
- Connection Issues
- Ensure your Flutter app is running in debug mode
- Verify the port matches in both Flutter app and MCP server
- Check if the port is not being used by another process
- AI Tool Not Detecting Inspector
- Restart the AI tool after configuration changes
- Verify the configuration JSON syntax
- Check the tool's logs for connection errors
The Flutter MCP Server is registered with Smithery's registry, making it discoverable and usable by other AI tools through a standardized interface.
Integration Architecture
🤝 Contributing
Contributions are welcome! Please feel free to submit pull requests or report issues on the GitHub repository.
📖 Learn More
- Flutter DevTools Documentation
- Dart VM Service Protocol
- Flutter DevTools RPC Constants (I guess and hope they are correct:))
Star History
📄 License
MIT - Feel free to use in your projects!
Flutter and Dart are trademarks of Google LLC.
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A MCP server with simple goal to debug Flutter apps by giving ability to AI coding assistants (Cline, Cursor, Claude etc..) tools to do analysis of widget trees, navigation, and layout issues. See Architecture to understand how it works https://github.com/Arenukvern/mcp_flutter/blob/main/ARCHITECTURE.md
- 📖 Documentation
- 🎉 v2 released! 🎉
- ⚠️ WARNING
- 🚀 Getting Started
- 🎯 AI Agent Tools
- 🔒 Security
- 🔧 Troubleshooting
- 🤝 Contributing
- 📖 Learn More
- Star History
- 📄 License
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityEnables interaction with the Flutter SDK by providing tools to analyze and apply fixes to Dart and Flutter files.Last updated -23JavaScript
- AsecurityAlicenseAqualityA Dart-based MCP server implementation that enables AI-assisted task management, document handling, and workspace organization through standardized tools and seamless Dart integration.Last updated -107352JavaScriptMIT License
- AsecurityAlicenseAqualityA distributable Model Context Protocol (MCP) server that exposes Dart SDK commands for AI-powered development. This server bridges the gap between AI coding assistants and Dart/Flutter development workflows by implementing the Model Context Protocol (MCP).Last updated -10112TypeScriptMIT License
- -securityFlicense-qualityAn MCP server that provides detailed information about your development environment to the Cursor code editor, enabling more context-aware assistance.Last updated -1Python