Flutter Inspector MCP Server

MCP-сервер + Flutter MCP Toolkit

Для разработки на основе ИИ

🔍 Сервер Model Context Protocol (MCP), который соединяет ваши приложения Flutter с помощниками по кодированию на основе ИИ, такими как Cursor, Claude, Cline, Windsurf, RooCode или любыми другими помощниками по ИИ, которые поддерживают сервер MCP

📖 Документация

• Быстрый старт
• Конфигурация

[!ПРИМЕЧАНИЕ] Команда Flutter разрабатывает новый экспериментальный пакет, который демонстрирует разработку инструментария Dart.

Поэтому сейчас я сосредоточен на

1. стабилизировать и отполировать инструменты, которые полезны при разработке (чтобы это было более просто, например: оно будет возвращать не только ошибки, но и подсказывать ИИ, как работать с этой ошибкой) , см. больше в MCP_RPC_DESCRIPTION.md
2. Тонкая настройка процесса создания инструментов сервера MCP путем его настройки.

Надеюсь, это будет вам полезно.

Хорошего дня!

🎉 v2 выпущена! 🎉

Теперь сервер Flutter MCP работает без сервера переадресации и расширения devtools. Подробнее см. в CHANGELOG.md .

⚠️ ВНИМАНИЕ!

Методы дампа RPC (например, dump_render_tree ) могут привести к использованию большого количества токенов или перегрузке контекста. Поэтому сейчас они отключены по умолчанию, но могут быть включены через переменную окружения DUMPS_SUPPORTED=true .

Более подробную информацию о переменных среды смотрите в .env.example .

🚀 Начало работы

• (Экспериментально) Вы можете попробовать установить сервер MCP и настроить его с помощью вашего AI Agent. Используйте следующую подсказку: Please install MCP server using this link: https://github.com/Arenukvern/mcp_flutter/blob/main/llm_install.md
• с курсором: https://www.youtube.com/watch?v=pyDHaI81uts
• с VSCode + Cline: используйте приглашение Please install MCP server using this link: https://github.com/Arenukvern/mcp_flutter/blob/main/llm_install.md
• Быстрый старт доступен на QUICK_START.md
• Параметры конфигурации доступны в CONFIGURATION.md

🎯 Инструменты ИИ-агента

Анализ ошибок

• get_app_errors [Ресурс|Инструмент] — извлекает точную и сжатую информацию об ошибках из вашего приложения Flutter. Использование :
  • Использует только краткое описание ошибки. Следует отфильтровывать дублирующиеся ошибки, чтобы избежать заполнения контекстного окна агента одинаковыми ошибками.
  • Использует Error Monitor для захвата ошибок Dart VM. Все ошибки захватываются в приложении Flutter, а затем доступны по запросу с сервера MCP.

  Протестировано на : ✅ macOS, ✅ iOS Не протестировано на : 🚧 Android, 🤔 Windows, 🤔 Linux, ❌ Web См. проблему

Инструменты разработки

• view_screenshot [Ресурс|Инструмент] — делает снимки экрана работающего приложения. Конфигурация :
  • Включите с помощью флага --images или переменной среды IMAGES_SUPPORTED=true
  • Будет использоваться сжатие PNG для оптимизации размера изображения.
• get_view_details [Ресурс|Инструмент] - размер экрана, соотношение пикселей. Может разблокировать возможность использования выбора виджета для Агента.

Если порт не указан, все инструменты по умолчанию используют порт 8181. Вы можете переопределить это, указав конкретный номер порта.

📚 Подробнее см. в MCP_RPC_DESCRIPTION

🔒 Безопасность

В целом, поскольку вы используете сервер MCP для подключения к приложению Flutter в режиме отладки, его использование должно быть безопасным. Тем не менее, я все же рекомендую ознакомиться с тем, как он работает в ARCHITECTURE.md , как его можно модифицировать для повышения безопасности, если это необходимо.

Этот сервер MCP проверен MseeP.ai .

🔧 Устранение неполадок

1. Проблемы с подключением
   • Убедитесь, что ваше приложение Flutter работает в режиме отладки.
   • Проверьте соответствие портов в приложении Flutter и сервере MCP.
   • Проверьте, не используется ли порт другим процессом.
2. Инструмент ИИ не обнаруживает инспектора
   • Перезапустите инструмент ИИ после изменения конфигурации.
   • Проверьте синтаксис конфигурации JSON
   • Проверьте журналы инструмента на наличие ошибок подключения.

Сервер Flutter MCP зарегистрирован в реестре Smithery, что делает его доступным для обнаружения и использования другими инструментами ИИ через стандартизированный интерфейс.

Архитектура интеграции

🤝 Вклад

Вклады приветствуются! Не стесняйтесь отправлять запросы на включение изменений или сообщать о проблемах в репозитории GitHub .

📖 Узнать больше

• Документация Flutter DevTools
• Протокол службы виртуальной машины Dart
• Константы RPC Flutter DevTools (я предполагаю и надеюсь, что они верны:))

История Звезды

📄 Лицензия

MIT — смело используйте в своих проектах!

Flutter и Dart являются товарными знаками Google LLC.