flutter_ai_whisper 1.0.0

MCP server that inspects and injects state in a running Flutter app over the Dart VM Service, supporting route navigation and Riverpod, Bloc and GetX.

example/README.md

Example: driving a Flutter app from an MCP client

A minimal Flutter app with three top-level state objects, then the MCP calls that read and mutate them.

The app is intentionally simple — the point is to show what the tools can reach without any instrumentation.

1. The app

// lib/main.dart
import 'package:flutter/material.dart';

final CounterCubit counterCubit = CounterCubit();

void main() => runApp(const MyApp());

class CounterCubit {
  int _count = 0;
  int get count => _count;
  void setValue(int v) => _count = v; // setter for the agent to call
  void increment() => _count++;
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      initialRoute: '/',
      routes: {
        '/': (_) => const HomePage(),
        '/profile': (_) => const Scaffold(body: Text('Profile')),
      },
      home: const HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('count: ${counterCubit.count}'),
            const SizedBox(height: 16),
            ElevatedButton(
              onPressed: counterCubit.increment,
              child: const Text('increment'),
            ),
          ],
        ),
      ),
    );
  }
}

Note the explicit setValue. Top-level objects are final, so the agent cannot assign counterCubit itself — it calls a method instead.

2. Run it

flutter run -d chrome

Copy the line the agent needs:

This app is linked to the debug service: ws://127.0.0.1:56660/RsqcVzTFmw0=/ws

3. Register the MCP server

.mcp.json:

{
  "mcpServers": {
    "flutter-ai-whisper": {
      "command": "dart",
      "args": ["run", "/abs/path/to/flutter_ai_whisper/bin/main.dart"]
    }
  }
}

4. Drive it

Connect:

{ "name": "connect_to_app",
  "arguments": { "vmUri": "ws://127.0.0.1:56660/RsqcVzTFmw0=/ws" } }

Read state (named explicitly — required on Flutter Web):

{ "name": "list_active_state_holders",
  "arguments": { "expressions": ["counterCubit.count"] } }

Mutate:

{ "name": "inject_state_variable",
  "arguments": { "expression": "counterCubit.setValue(42)" } }

Navigate:

{ "name": "trigger_route_navigation",
  "arguments": { "routePath": "/profile" } }

The app UI updates live between calls.

5. Private widget state

To reach a private field, evaluate inside its declaring library:

{ "name": "inject_state_variable",
  "arguments": {
    "libraryUri": "package:my_app/pages/home_page.dart",
    "expression": "(() { final s = targetState as _HomePageState; s.setState(() { s._localCounter = 12; }); })()"
  }
}

Next steps

See README.md for Riverpod, Bloc and GetX recipes, the platform support matrix, and troubleshooting.