flutter_ui_mcp #

An interactive AI Agent chat and execution widget for Flutter — connect to any LLM provider, register local Dart-native tools and remote HTTP MCP servers, and run agentic workflows in a conversational UI.

✨ Features #

• Multi-LLM support – OpenAI, Anthropic Claude, Google Gemini, Ollama (local), Mistral AI, and any OpenAI-compatible endpoint.
• Embedded on-device models – Run local GGUF models via llamadart without external network dependencies.
• HTTP MCP Server registry – Browse PulseMCP and Smithery catalogs or add custom remote MCP servers.
• Local MCP subprocesses – Install, configure, and launch local stdio MCP servers (Node.js, Python) directly within the application (supported in desktop mode).
• Dart-native local tools – Extend with custom Dart-native tools (e.g., Weather, SSH, Chart-generation tools; see the example implementation).
• Agentic tool loop – Automatic iterative tool calling with duplicate-call detection, iteration limits, and safety guards.
• Save/Load configurations – Persist LLM settings, tool selections, system prompts, and server lists via SharedPreferences or a custom McpPlaygroundStorageDelegate.
• Agent Inspector – Side-by-side conversation + internal state inspector for debugging agent behavior (can be toggled or disabled via showAgentInspector).
• Cross-platform – Works on Android, iOS, Web, macOS, Windows, and Linux.

🎥 Demo #

Watch the AI Agent widget in action using an embedded model to call local dart tools:

🚀 Installation #

Add to your pubspec.yaml:

dependencies:
  flutter_ui_mcp: ^1.0.2

Then import:

import 'package:flutter_ui_mcp/flutter_ui_mcp.dart';

📦 Widget API #

FlutterUiMcp (or McpPlayground) #

The main widget. Drop it into your app to get a full AI agent interface.

Basic usage

FlutterUiMcp()

With Pre-configured LLM

FlutterUiMcp(
  initialLlmConfig: const LlmConfig(
    provider: LlmProvider.openai,
    model: 'gpt-4o',
    apiKey: 'sk-...',
  ),
)

📂 Example Projects #

Explore the runnable showcases in this repository:

• flutter_ui_mcp/example – Complete showcase app demonstrating custom SSH, Open-Meteo weather, and fl_chart tool integrations.
• examples/flutter/example_device_diagnostics – Telemetry monitor with custom chat cards for battery, memory, CPU load, and latency.
• examples/flutter/example_audio_notes – Meeting notes processor with action item checklist cards.
• examples/flutter/example_github_triage – GitHub issue triage assistant with inline PR code reviews.
• examples/flutter/example_embedded – Local on-device embedded LLM (llamadart) with zero external network dependencies.