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.
- 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
- Python 3.7+
- A running Flutter application with VM service enabled
- UV package manager (or pip)
- Claude AI with MCP support
- Clone the repository:
git clone https://github.com/yourusername/flutter_surf_mcp.git
cd flutter_surf_mcp- Install dependencies:
uv pip install -r requirements.txtTo 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());
}