Flutter Breakpoint Listener

A Dart console application that listens to Flutter/Dart breakpoint events via VM Service and logs debug information to file. Also provides an MCP Server for AI assistants like Claude to control debugging.

Features

• Connect to Dart VM Service via WebSocket
• Listen to breakpoint pause events
• Log stack traces with absolute file paths
• Inspect local variables at breakpoints
• MCP Server integration for AI-assisted debugging

Installation

dart pub add flutter_breakpoint_listener

Usage

Command Line

# Interactive mode
dart run flutter_breakpoint_listener

# With arguments
dart run flutter_breakpoint_listener --uri ws://127.0.0.1:12345/xxx=/ws --output debug.txt

# Show help
dart run flutter_breakpoint_listener --help

Options

Option	Short	Description
--uri	-u	VM Service WebSocket URI
--output	-o	Output file path
--project	-p	Flutter project path for resolving package URIs
--clear	-c	Clear output file on start
--help	-h	Show help

Getting VM Service URI

When you run a Flutter app in debug mode, you'll see something like:

The Dart VM service is listening on http://127.0.0.1:12345/xxx=/

Convert this to WebSocket URI by:

1. Change http:// to ws://
2. Add ws at the end

Example: ws://127.0.0.1:12345/xxx=/ws

MCP Server

This package includes an MCP (Model Context Protocol) server that allows AI assistants to control debugging sessions.

dart run flutter_breakpoint_listener:mcp_server

License

MIT License - see LICENSE file for details.