MCP Server + Flutter MCP Toolkit

Created By

Arenukvern9 months ago

MCP server for Dart VM and Flutter

# dart

# mcp

Overview Content Tools Comments

Content

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

View Screenshots

📖 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.1.0 released! 🎉

Added Dart MCP Server to replace in future Typescript one. Already working, will migrate to it in the future. See more about it 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 or IMAGES_SUPPORTED=true environment variable
- Will use PNG compression to optimize image size.

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

┌─────────────────┐     ┌───────────────────────┐     ┌─────────────────┐
│                 │     │  Flutter App with     │     │                 │
│  Flutter App    │<--->│  mcp_toolkit (VM Svc.  │<--->│   MCP Server   │
│  (Debug Mode)   │     │  Extensions)          │     │                 │
│                 │     │                       │     │                 │
└─────────────────┘     └───────────────────────┘     └─────────────────┘