mcp_suite 0.1.1

Model Context Protocol (MCP) monorepo ecosystem umbrella package for Flutter & Dart.

⚡ Flutter MCP Suite (mcp_suite)

Supercharge your Flutter app with Model Context Protocol (MCP) for seamless Vibe Coding with AI Agents (Antigravity, Cursor, Claude Desktop).

---

📦 What is MCP Suite?

Instead of a heavy, monolithic package, Flutter MCP Suite is a modular monorepo. Use the full suite or pick only the packages you need:

Package	What it does	Quick Import
🧩 mcp_suite_core	JSON-RPC 2.0 models, McpServer, & logger	import 'package:mcp_suite_core/mcp_suite_core.dart';
🔍 mcp_suite_inspector	Live widget tree inspection & state snapshots	import 'package:mcp_suite_inspector/mcp_suite_inspector.dart';
🤖 mcp_suite_driver	AI UI testing & gesture injection (tap, text)	import 'package:mcp_suite_driver/mcp_suite_driver.dart';
🖥️ mcp_suite_desktop	Native OS hardware hooks & window controls	import 'package:mcp_suite_desktop/mcp_suite_desktop.dart';
📦 mcp_suite	Full Suite Umbrella (All modules in one place)	import 'package:mcp_suite/mcp_suite.dart';

---

🪄 Vibe Coding with AI

Vibe Coding allows AI agents to interact with your live Flutter application during development.

How it works:

1. Live State Inspection: Your AI agent queries the widget tree and state in real-time to debug issues.
2. Automated UI Testing: AI triggers taps, scrolling, and input actions automatically.
3. Fast Iteration: Tell your AI what to change, and let it inspect and verify the app while it runs!

---

🚀 Quickstart

Option 1: Full Suite (Recommended)

Add to pubspec.yaml:

dependencies:
  mcp_suite: ^0.1.1

Wrap your app:

import 'package:flutter/material.dart';
import 'package:mcp_suite/mcp_suite.dart';

void main() {
  runApp(
    McpInspectorWrapper(
      child: const MyApp(),
    ),
  );
}

---

Option 2: Pick Specific Packages (A-la-Carte)

If you only need UI testing or core RPC models:

dependencies:
  mcp_suite_driver: ^0.1.1

import 'package:mcp_suite_driver/mcp_suite_driver.dart';

void runTest() async {
  final driver = McpAiDriver();
  await driver.tapElementByText('Submit');
}

---

📱 Working Example

Check out the runnable demo in the example/ directory to see live widget tree inspection and AI driver triggers in action.

---

🛠️ Monorepo Commands (Melos)

If you are contributing or working inside this repository:

# Install dependencies across all packages
melos bootstrap

# Run tests
melos run test

# Run static analysis
melos run analyze

---

⭐ Show Your Support

If you find this package helpful, please consider:

• 👍 Giving a Like on pub.dev
• ⭐ Giving a Star on GitHub

Your support helps maintain and expand the MCP Flutter ecosystem!

---

📄 License

MIT License - see LICENSE for details.