Add the Flutter launcher tools (#292)

Author: gspencergoog

pkgs/dart_mcp_server/CHANGELOG.md

@@ -16,6 +16,8 @@
 * Stop reporting non-zero exit codes from command line tools as tool errors.
 * Add descriptions for pub tools, add support for `pub deps` and `pub outdated`.
 * Fix a bug in hot_reload ([#290](https://github.com/dart-lang/ai/issues/290)).
+* Add the `list_devices`, `launch_app`, `get_app_logs`, and `list_running_apps`
+  tools for running Flutter apps.
 
 # 0.1.0 (Dart SDK 3.9.0)
 

pkgs/dart_mcp_server/README.md

@@ -135,25 +135,30 @@ For more information, see the official VS Code documentation for
 
 | Tool Name | Title | Description |
 | --- | --- | --- |
+| `add_roots` | Add roots | Adds one or more project roots. Tools are only allowed to run under these roots, so you must call this function before passing any roots to any other tools. |
+| `analyze_files` | Analyze projects | Analyzes specific paths, or the entire project, for errors. |
 | `connect_dart_tooling_daemon` | Connect to DTD | Connects to the Dart Tooling Daemon. You should get the uri either from available tools or the user, do not just make up a random URI to pass. When asking the user for the uri, you should suggest the "Copy DTD Uri to clipboard" action. When reconnecting after losing a connection, always request a new uri first. |
+| `create_project` | Create project | Creates a new Dart or Flutter project. |
+| `dart_fix` | Dart fix | Runs `dart fix --apply` for the given project roots. |
+| `dart_format` | Dart format | Runs `dart format .` for the given project roots. |
+| `flutter_driver` | Flutter Driver | Run a flutter driver command |
+| `get_active_location` | Get Active Editor Location | Retrieves the current active location (e.g., cursor position) in the connected editor. Requires "connect_dart_tooling_daemon" to be successfully called first. |
+| `get_app_logs` |  | Returns the collected logs for a given flutter run process id. Can only retrieve logs started by the launch_app tool. |
 | `get_runtime_errors` | Get runtime errors | Retrieves the most recent runtime errors that have occurred in the active Dart or Flutter application. Requires "connect_dart_tooling_daemon" to be successfully called first. |
-| `hot_reload` | Hot reload | Performs a hot reload of the active Flutter application. This is to apply the latest code changes to the running application. Requires "connect_dart_tooling_daemon" to be successfully called first. |
-| `get_widget_tree` | Get widget tree | Retrieves the widget tree from the active Flutter application. Requires "connect_dart_tooling_daemon" to be successfully called first. |
 | `get_selected_widget` | Get selected widget | Retrieves the selected widget from the active Flutter application. Requires "connect_dart_tooling_daemon" to be successfully called first. |
-| `set_widget_selection_mode` | Set Widget Selection Mode | Enables or disables widget selection mode in the active Flutter application. Requires "connect_dart_tooling_daemon" to be successfully called first. This is not necessary when using flutter driver, only use it when you want the user to select a widget. |
-| `get_active_location` | Get Active Editor Location | Retrieves the current active location (e.g., cursor position) in the connected editor. Requires "connect_dart_tooling_daemon" to be successfully called first. |
-| `flutter_driver` | Flutter Driver | Run a flutter driver command |
+| `get_widget_tree` | Get widget tree | Retrieves the widget tree from the active Flutter application. Requires "connect_dart_tooling_daemon" to be successfully called first. |
+| `hot_reload` | Hot reload | Performs a hot reload of the active Flutter application. This is to apply the latest code changes to the running application. Requires "connect_dart_tooling_daemon" to be successfully called first. |
+| `hover` | Hover information | Get hover information at a given cursor position in a file. This can include documentation, type information, etc for the text at that position. |
+| `launch_app` |  | Launches a Flutter application and returns its DTD URI. |
+| `list_devices` |  | Lists available Flutter devices. |
+| `list_running_apps` |  | Returns the list of running app process IDs and associated DTD URIs for apps started by the launch_app tool. |
+| `pub` | pub | Runs a pub command for the given project roots, like `dart pub get` or `flutter pub add`. |
 | `pub_dev_search` | pub.dev search | Searches pub.dev for packages relevant to a given search query. The response will describe each result with its download count, package description, topics, license, and publisher. |
 | `remove_roots` | Remove roots | Removes one or more project roots previously added via the add_roots tool. |
-| `add_roots` | Add roots | Adds one or more project roots. Tools are only allowed to run under these roots, so you must call this function before passing any roots to any other tools. |
-| `dart_fix` | Dart fix | Runs `dart fix --apply` for the given project roots. |
-| `dart_format` | Dart format | Runs `dart format .` for the given project roots. |
-| `run_tests` | Run tests | Run Dart or Flutter tests with an agent centric UX. ALWAYS use instead of `dart test` or `flutter test` shell commands. |
-| `create_project` | Create project | Creates a new Dart or Flutter project. |
-| `pub` | pub | Runs a pub command for the given project roots, like `dart pub get` or `flutter pub add`. |
-| `analyze_files` | Analyze projects | Analyzes specific paths, or the entire project, for errors. |
 | `resolve_workspace_symbol` | Project search | Look up a symbol or symbols in all workspaces by name. Can be used to validate that a symbol exists or discover small spelling mistakes, since the search is fuzzy. |
+| `run_tests` | Run tests | Run Dart or Flutter tests with an agent centric UX. ALWAYS use instead of `dart test` or `flutter test` shell commands. |
+| `set_widget_selection_mode` | Set Widget Selection Mode | Enables or disables widget selection mode in the active Flutter application. Requires "connect_dart_tooling_daemon" to be successfully called first. This is not necessary when using flutter driver, only use it when you want the user to select a widget. |
 | `signature_help` | Signature help | Get signature help for an API being used at a given cursor position in a file. |
-| `hover` | Hover information | Get hover information at a given cursor position in a file. This can include documentation, type information, etc for the text at that position. |
+| `stop_app` |  | Kills a running Flutter process started by the launch_app tool. |
 
 <!-- generated -->

pkgs/dart_mcp_server/lib/src/mixins/analyzer.dart

@@ -17,6 +17,7 @@ import '../utils/analytics.dart';
 import '../utils/cli_utils.dart';
 import '../utils/constants.dart';
 import '../utils/file_system.dart';
+import '../utils/process_manager.dart';
 import '../utils/sdk.dart';
 
 /// Mix this in to any MCPServer to add support for analyzing Dart projects.
@@ -25,7 +26,7 @@ import '../utils/sdk.dart';
 /// mixins applied.
 base mixin DartAnalyzerSupport
     on ToolsSupport, LoggingSupport, RootsTrackingSupport, FileSystemSupport
-    implements SdkSupport {
+    implements SdkSupport, ProcessManagerSupport {
   /// The LSP server connection for the analysis server.
   Peer? _lspConnection;
 
@@ -94,7 +95,8 @@ base mixin DartAnalyzerSupport
   ///
   /// On failure, returns a reason for the failure.
   Future<String?> _initializeAnalyzerLspServer() async {
-    final lspServer = await Process.start(sdk.dartExecutablePath, [
+    final lspServer = await processManager.start([
+      sdk.dartExecutablePath,
       'language-server',
       // Required even though it is documented as the default.
       // https://github.com/dart-lang/sdk/issues/60574