mcp_flutter

This MCP server exposes a Flutter-based MCP Server that bridges your Flutter apps with AI coding assistants (Cursor, Claude, Cline, Windsurf, RooCode, or any MCP-enabled AI tool). It supports dynamic tools registration, so your Flutter app can register custom tools at runtime and expose them to connected agents. To start, launch the server (for example via Docker) and point your MCP clients to the server endpoint. Once running, you can use the included Flutter tools like get_app_errors, view_screenshot, and get_view_details, as well as dynamically registered tools provided by your Flutter app. Configure the server through the command line and configuration docs, then test integrations with an AI agent to verify tool discovery and response flows.

Prerequisites:

• Docker installed on your machine (recommended for quick start)
• Optional: Flutter/Dart SDK if you prefer building or running locally without Docker

Installation steps (Docker):

1. Ensure Docker is running on your machine.
2. Pull and run the MCP Flutter server image: docker run -i arenukvern/mcp_flutter
3. If needed, map ports to your host and set environment variables (for example MCP_PORT or DEBUG) when starting the container: docker run -i -p 8181:8181 -e MCP_PORT=8181 -e DEBUG=true arenukvern/mcp_flutter

Alternative (local Dart/Flutter setup):

1. Install Flutter and ensure Dart is available.
2. Clone the repository: git clone https://github.com/Arenukvern/mcp_flutter.git
3. Navigate to the project directory and follow the project’s QUICK_START.md and mcp_server_dart README for running the Dart-based MCP server locally.
4. Start the server with the recommended dart/flutter commands as documented in the repository.

Prerequisites summary:

• Docker (recommended) or Flutter/Dart SDK
• Basic familiarity with running containers or Dart/Flutter apps

Tips and caveats:

• Dynamic Tools Registration lets your Flutter app publish custom tools at runtime; ensure your app initializes mcp_toolkit and registers tools via MCPToolkitBinding.instance.addEntries().
• Some RPC methods (e.g., dump_render_tree) can generate large token usage; the server may disable them by default and require a flag to enable. Check the CLI docs for enabling dumps.
• If tools do not appear in an agent, verify that the Flutter app is running in debug mode, the port matches between client and server, and that tools are properly registered in the app (listClientToolsAndResources can help).
• If you use Docker, ensure port mappings align with your agent configuration and that any required environment variables (like MCP_PORT) are set.
• This server focuses on dynamic tool registration and Flutter-based tooling; for broader MCP capabilities, refer to the Quick Start and Configuration docs in the repository.