Flutter Surf Mcp
What is Flutter Surf Mcp
Flutter Surf MCP is a server designed to facilitate interactions with Flutter applications using client LLMs. It allows developers to programmatically inspect, control, and automate Flutter apps.
Use cases
Use cases for Flutter Surf MCP include automating UI tests, inspecting the state of widgets during development, controlling app behavior programmatically, and enhancing debugging capabilities.
How to use
To use Flutter Surf MCP, clone the repository, install the required dependencies, and configure it with Claude AI settings. Ensure that you have a running Flutter application with VM service enabled.
Key features
Key features include connecting to running Flutter applications via VM Service, retrieving and inspecting widget tree state, clicking on widgets, entering text into input fields, finding widgets by text, key, or type, scrolling widgets into view, performing scrolling actions with customizable parameters, and toggling debug paint features.
Where to use
Flutter Surf MCP can be used in mobile application development, automated testing, UI inspection, and debugging processes for Flutter applications.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Flutter Surf Mcp
Flutter Surf MCP is a server designed to facilitate interactions with Flutter applications using client LLMs. It allows developers to programmatically inspect, control, and automate Flutter apps.
Use cases
Use cases for Flutter Surf MCP include automating UI tests, inspecting the state of widgets during development, controlling app behavior programmatically, and enhancing debugging capabilities.
How to use
To use Flutter Surf MCP, clone the repository, install the required dependencies, and configure it with Claude AI settings. Ensure that you have a running Flutter application with VM service enabled.
Key features
Key features include connecting to running Flutter applications via VM Service, retrieving and inspecting widget tree state, clicking on widgets, entering text into input fields, finding widgets by text, key, or type, scrolling widgets into view, performing scrolling actions with customizable parameters, and toggling debug paint features.
Where to use
Flutter Surf MCP can be used in mobile application development, automated testing, UI inspection, and debugging processes for Flutter applications.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Flutter Surf MCP
Flutter Surf MCP is a MCP server that allows interactions with Flutter applications through client LLMs. It provides tools to inspect, control, and automate Flutter applications programmatically.
Features
- Connect to running Flutter applications via VM Service
- Retrieve and inspect widget tree state
- Click on widgets
- Enter text into input fields
- Find widgets by text, key, or type
- Scroll widgets into view
- Perform scrolling actions with customizable parameters
- Toggle debug paint features
Requirements
- Python 3.7+
- A running Flutter application with VM service enabled
- UV package manager (or pip)
- Claude AI with MCP support
Installation
- Clone the repository:
git clone https://github.com/yourusername/flutter_surf_mcp.git
cd flutter_surf_mcp
- Install dependencies:
uv pip install -r requirements.txt
Configuration
To use Flutter Surf MCP with Claude, add the following configuration to your Claude AI settings:
{
"mcpServers": {
"flutter_mcp": {
"command": "[uv_directory]",
"args": [
"--directory",
"[path]/flutter_surf_mcp",
"run",
"flutter_surf_mcp.py"
]
}
}
}Note: Make sure to enable the flutter driver extension:
import 'package:flutter_driver/driver_extension.dart';
void main() {
enableFlutterDriverExtension();
runApp(const HomeScreen());
}
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
