Flutter MCP Toolkit — MCP-сервер для Claude Code: как настроить
Управляет отладочными сборками Flutter через семантические снимки, горячую перезагрузку и поиск виджетов. Пригодится при автотестах и интерактивной отладке приложений.
claude mcp add mcp_server_dart -- docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.0.1Что делает Flutter MCP Toolkit
Сервер подключается к запущенному в debug-режиме приложению Flutter. Команды агента транслируются через инструменты с префиксом fmt_. Сервер снимает семантические слепки интерфейса, нажимает на виджеты и вводит текст. Для действий используется модель ссылок по аналогии с Playwright: агент вызывает semantic_snapshot, получает ссылку вида s_N и передаёт её в fmt_tap_widget.
Внутри находится библиотека flutter_mcp_core. Она связывает протокол MCP и CLI-утилиту fmtk. Сервер умеет выполнять горячую перезагрузку с одновременным снимком экрана в fmt_hot_reload_and_capture. Доступны дампы деревьев рендеринга и вычисление произвольных выражений на Dart прямо в запущенном приложении.
Чтобы сервер работал, в проект добавляют пакет mcp_toolkit и вызывают MCPToolkitBinding.instance.bootstrapFlutter(...). Приложение запускают строго в режиме отладки. Без запущенного debug-процесса или установленного Docker сервер бесполезен.
Какие задачи решает
- находить и нажимать виджеты по семантическим слепкам интерфейса
- выполнять горячую перезагрузку с фиксацией скриншота и свежих ошибок
- прокручивать списки до нужного элемента через поиск reveal_search
- выполнять произвольные Dart-выражения в корневой библиотеке приложения
- снимать дампы деревьев рендеринга, семантики и фокуса для отладки
Примеры запросов агенту
- Сделай семантический снимок приложения через
fmt_semantic_snapshotи найди кнопку входа. - Нажми на элемент с идентификатором
s_1и проверь появившиеся ошибки в логах. - Выполни
fmt_hot_reload_and_capture, чтобы обновить экран и сразу проверить интерфейс.
Как установить Flutter MCP Toolkit
Командой платформы
claude mcp add mcp_server_dart -- docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.0.1Командой платформы
codex mcp add mcp_server_dart -- docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.0.1Файл настроек
{
"mcpServers": {
"mcp_server_dart": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/arenukvern/flutter-mcp-toolkit:7.0.1"
]
}
}
}Файл настроек
{
"servers": {
"mcp_server_dart": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/arenukvern/flutter-mcp-toolkit:7.0.1"
]
}
}
}Командой платформы
gemini mcp add mcp_server_dart docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.0.1По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Flutter MCP Toolkit
Как установить Flutter MCP Toolkit в Claude Code?
Выполните команду claude mcp add mcp_server_dart -- docker run -i --rm ghcr.io/arenukvern/flutter-mcp-toolkit:7.0.1. Для работы потребуется установленный и запущенный Docker.
Что делает Flutter MCP Toolkit?
Он связывает ИИ-агента с отладочной версией Flutter-приложения. Агент может кликать по виджетам, вводить текст, читать логи и выполнять перезагрузку кода на лету.
Что нужно добавить в проект Flutter для работы инструментов?
В приложение нужно подключить библиотеку mcp_toolkit и вызвать метод MCPToolkitBinding.instance.bootstrapFlutter(...). Приложение обязательно запускают в debug-режиме.
