
A comprehensive toolset for Flutter development with AI assistant integration through the Model
A comprehensive toolset for Flutter development with AI assistant integration through the Model Context Protocol.
·
A comprehensive toolset for Flutter development with AI assistant integration through the Model Context Protocol.
This project provides a powerful platform for interacting with Flutter applications programmatically, enabling AI assistants and development tools to inspect, control, and optimize Flutter apps. The system follows a two-component architecture that provides scalability and robustness.
The project consists of two main components:
Flutter Connector Server: A standalone server that monitors Flutter applications, providing direct access to their state, logs, performance metrics, and more.
MCP Server: A Model Context Protocol server that provides AI assistants with tools to interact with Flutter applications through a standardized interface.
These components work together to provide a seamless experience for debugging, testing, and analyzing Flutter applications.
┌──────────────────┐ ┌───────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ AI Assistant │◄─────────┤ MCP Server │◄─────────┤ Flutter │
│ (Claude, etc.) │ MCP │ (Tool Provider) │ REST │ Connector │
│ ├─────────►│ ├─────────►│ Server │
└──────────────────┘ └───────────────────┘ └────────┬────────┘
│
│ VM Service
│ Protocol
▼
┌─────────────────┐
│ │
│ Flutter Apps │
│ (Debugging Mode)│
│ │
└─────────────────┘The system works as follows:
Application Management
Device Management
Debugging Capabilities
Analytics and Insights
Reliability
Clone the repository:
git clone https://github.com/yourusername/flutter-tools-mcp.git
cd flutter-tools-mcpInstall dependencies for both components:
# Install MCP server dependencies
cd mcp
npm install
npm run build
cd ..
# Install Flutter Connector Server dependencies
cd flutter-connector-server
npm install
npm run build
cd ..You need to run both the Flutter Connector Server and the MCP Server:
Start the Flutter Connector Server:
cd flutter-connector-server
npm startThis will start the connector server on port 5051 by default.
Start the MCP Server (in a new terminal):
cd mcp
npm startThis will start the MCP server running on stdio, ready to connect to MCP clients.
To use the Flutter Tools MCP with your Flutter applications, follow these steps:
Launch your Flutter app in debug mode:
flutter runNote the VM Service URL that appears in the console output. It will look something like:
Connecting to VM Service at ws://127.0.0.1:55285/xxxxxxxxxxxx=/wsIMPORTANT: Connect to your Flutter app using the VM Service URL first:
This is a crucial step! Before using any other tools, you must first connect to your Flutter app using the connect-by-url tool with the VM Service URL from step 2.
Example:
connect-by-url --vmServiceUrl ws://127.0.0.1:55285/xxxxxxxxxxxx=/wsAfter connecting, you can use all other tools with the app ID returned from the connection step:
get-performance-metrics --appId YOUR_APP_ID
get-app-logs --appId YOUR_APP_ID
take-screenshot --appId YOUR_APP_IDTo use the Flutter Tools MCP with Claude for Desktop:
Open the Claude for Desktop configuration file:
# On macOS
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
# On Windows
notepad %APPDATA%\Claude\claude_desktop_config.jsonAdd the configuration for the Flutter Tools MCP:
{
"mcpServers": {
"flutter-tools": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/flutter-tools-mcp/mcp/build/index.js"
]
}
}
}Make sure to replace /ABSOLUTE/PATH/TO with the actual absolute path to your project directory.
Save the file and restart Claude for Desktop.
You should now see the Flutter tools icon in the Claude for Desktop interface.
Remember: Always use the connect-by-url tool first with your VM Service URL before using any other tools.
To integrate with Cursor:
node /ABSOLUTE/PATH/TO/flutter-tools-mcp/mcp/build/index.jsconnect-by-url tool and the VM Service URL before using any other tools.The MCP server provides the following tools for AI assistants:
| Tool Name | Description |
|---|---|
connect-by-url | FIRST STEP: Connect to a Flutter app using the VM Service URL |
list-flutter-apps | List all running Flutter applications |
connect-to-app | Connect to a specific Flutter app by ID |
get-app-logs | Retrieve logs from a connected Flutter app |
get-performance-metrics | Get performance metrics from a Flutter app |
get-network-requests | Fetch network request data from a Flutter app |
take-screenshot | Capture a screenshot of the Flutter app UI |
get-widget-tree | Retrieve the widget tree structure of a Flutter app |
analyze-performance | Run a performance analysis on the Flutter app |
GET /api/apps - List running apps
GET /api/apps/{appId} - Get app details
POST /api/apps/from-url - Add an app using VM service URL
GET /api/apps/{appId}/logs - Get app logs
GET /api/apps/{appId}/metrics - Get performance metrics
GET /api/apps/{appId}/network - Get network traffic
GET /api/apps/{appId}/screenshot - Take screenshot
GET /api/apps/{appId}/widget-tree - Get widget tree
GET /api/health - Server health checkflutter-tools-mcp/
├── mcp/ # MCP server
│ ├── src/
│ │ ├── tools/ # Tool implementations
│ │ ├── services/ # Services (connector client, etc.)
│ │ ├── types/ # TypeScript type definitions
│ │ └── index.ts # Main entry point
│ └── package.json
│
├── flutter-connector-server/ # Flutter Connector Server
│ ├── src/
│ │ ├── services/ # Core services
│ │ ├── controllers/ # API controllers
│ │ ├── utils/ # Utility functions
│ │ └── server.ts # Server implementation
│ └── package.json
│
└── README.md # This documentation fileTo run the servers with auto-reloading during development:
# MCP Server
cd mcp
npm run dev
# Flutter Connector Server
cd flutter-connector-server
npm run devContributions are welcome! Please feel free to submit pull requests.
git checkout -b feature/amazing-feature)git commit -m 'Add some amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add flutter-tools -- node /ABSOLUTE/PATH/TO/flutter-tools-mcp/mcp/build/index.js{
"mcpServers": {
"flutter-tools": {
"args": [
"/ABSOLUTE/PATH/TO/flutter-tools-mcp/mcp/build/index.js"
],
"command": "node"
}
}
}code --add-mcp '{"name":"flutter-tools","args":["/ABSOLUTE/PATH/TO/flutter-tools-mcp/mcp/build/index.js"],"command":"node"}'[mcp_servers.flutter-tools]
command = "node"
args = ["/ABSOLUTE/PATH/TO/flutter-tools-mcp/mcp/build/index.js"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/flutter-tools-mcp to learn what the "Flutter Tools MCP" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/flutter-tools-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "flutter-tools-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.