Flutter MCP Toolkit

Flutter MCP Toolkit — MCP-сервер сообщества (автор — Arenukvern). Инспекция и управление отладочными Flutter-приложениями и играми. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Arenukvern
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
dart

Уровень риска: high

Управляет запущенным отладочным Flutter-приложением (нажатия, ввод, перезагрузка); захват экрана; запись скриншотов и снимков на диск.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"flutter-mcp-toolkit\": {\n      \"command\": \"/path/to/your/cloned/mcp_flutter/mcp_server_dart/build/flutter-mcp-toolkit-server\",\n      \"args\": [\n        \"--dart-vm-host=localhost\",\n        \"--dart-vm-port=8181\",\n        \"--resources\",\n        \"--images\",\n        \"--dynamics\"\n      ],\n      \"env\": {},\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}",
    "lang": "json",
    "notes": "Features → Model Context Protocol, дословно из README",
    "verified": "docs"
}

Что умеет

MCP Toolkit Server (Dart) — MCP-сервер проекта mcp_flutter, который подключает ИИ-ассистента к запущенному в режиме отладки Flutter-приложению через Dart VM. Ассистент видит интерфейс приложения, делает скриншоты, нажимает на виджеты, вводит текст, выполняет горячую перезагрузку и разбирает ошибки. В версии 3 инструменты MCP получили префикс fmt_, а исполняемые файлы и ключи mcpServers переименованы — при обновлении с 2.x нужна миграция.

Возможности по README:

  • инспекция: поиск запущенных отладочных приложений, снимок интерфейса (capture_ui_snapshot), просмотр виджета по координатам, сведения о VM и расширениях;
  • взаимодействие по модели ссылок в стиле Playwright: снимок семантики, затем нажатие, ввод текста, прокрутка, свайп, долгое нажатие и перетаскивание по ссылке на элемент;
  • разработка: горячая перезагрузка и перезапуск (fmt_hot_reload_and_capture), объяснение ошибок, диагностика;
  • скриншоты: изображения в ответе или файлами в папке .mcp_screenshots (флаг --save-images, старые файлы удаляются через 24 часа);
  • динамический реестр: приложение может само регистрировать инструменты и ресурсы (fmt_list_client_tools_and_resources, fmt_client_tool, fmt_client_resource).

Тот же набор команд доступен через CLI flutter-mcp-toolkit (короткий псевдоним fmtk), включая validate-runtime для проверки подключения.

Кому подойдёт

  • Flutter-разработчикам, которые хотят, чтобы ассистент видел и проверял интерфейс приложения во время разработки.
  • Тем, кто автоматизирует UI-проверки Flutter-приложений на macOS, вебе, iOS и Android.

Похожие серверы — в категории разработка.

Установка

Сейчас рекомендуется установка из GitHub:

git clone https://github.com/Arenukvern/mcp_flutter
cd mcp_flutter
make install

Затем добавьте пакет mcp_toolkit в приложение (flutter pub add mcp_toolkit), инициализируйте MCPToolkitBinding в main.dart и запустите приложение в режиме отладки, например flutter run --debug --machine --host-vmservice-port=8181 -d macos. Команда flutter-mcp-toolkit init claude-code (или cursor, codex, cline) сама настраивает навыки и конфиг клиента.

Подключение к клиентам

Конфиги приведены дословно из README; укажите путь к собранному flutter-mcp-toolkit-server. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "flutter-mcp-toolkit": {
      "command": "/path/to/your/cloned/mcp_flutter/mcp_server_dart/build/flutter-mcp-toolkit-server",
      "args": [
        "--dart-vm-host=localhost",
        "--dart-vm-port=8181",
        "--resources",
        "--images",
        "--dynamics"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

В Cursor блок добавляется в настройках: вкладка Features, раздел Model Context Protocol. Для Cline README приводит такой же блок для .cline/config.json. Порт 8181 должен совпадать с портом VM, с которым запущено приложение.

Проверка

Запустите приложение в режиме отладки и выполните fmtk validate-runtime. Затем попросите ассистента: «Сделай скриншот моего приложения».

Примеры задач

Сделай снимок интерфейса, найди кнопку «Войти», введи тестовый email и нажми её, затем покажи скриншот.
Выполни горячую перезагрузку после моих правок и объясни ошибки, если они появились.

Риски

  • Управление приложением. Ассистент нажимает, вводит текст и перезагружает запущенное приложение. Подключайте его только к отладочным сборкам с тестовыми данными.
  • Захват экрана. На macOS захват окна требует разрешения Screen Recording для терминала или клиента, в котором работает сервер. Скриншоты могут содержать всё, что видно в окне.
  • Файлы. С --save-images скриншоты пишутся в .mcp_screenshots в рабочей папке. Команды snapshot и bundle поддерживают флаги безопасной записи --check, --diff, --backup, --no-overwrite.
  • Динамические инструменты. С --dynamics приложение само регистрирует инструменты для ассистента — включайте это только для своих приложений.
  • Поле autoApprove в конфиге оставлено пустым: не добавляйте туда инструменты взаимодействия без необходимости.

Частые вопросы

Нужно ли менять код приложения?

Да. Добавьте пакет mcp_toolkit и инициализируйте MCPToolkitBinding в main.dart, иначе сервер не увидит нужные расширения.

Что изменилось в версии 3?

Инструменты MCP получили префикс fmt_, исполняемые файлы и ключи конфигурации переименованы. Старый ключ flutter-inspector пока принимается.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

paperclip

Оценки популярности хип-хоп исполнителей по четырём культурным измерениям.

Риск: medium Лицензия: MIT ★ 114 818

Coder

Управление рабочими пространствами, шаблонами и облачными средами разработки Coder.

Риск: medium Лицензия: AGPL-3.0 ★ 17 363

Источники