Flutter Inspector MCP 服务器,助力 AI 开发
🔍 模型上下文协议 (MCP) 服务器,将您的 Flutter 应用与 AI 编码助手(如 Cursor、Claude、Cline、Windsurf、RooCode 或任何其他支持 MCP 服务器的 AI 助手)连接起来
观看小视频教程,了解如何使用 Cursor 在 macOS 上设置 mcp 服务器 - https://www.youtube.com/watch?v=NBY2p7XIass
[!NOTE] 由于正在开发一个新的实验包,它向客户端公开了 Dart 工具开发工具操作,因此将来可能不再需要这个项目。
因此我目前的重点是
- 稳定和完善这些在开发中有用的工具(因此它将更加即插即用) ,更多信息请参见 MCP_RPC_DESCRIPTION.md
- 找到不使用转发服务器的解决方法。
希望对你有用,
祝你今天过得愉快!
目前 Flutter 通过转发服务器与 MCP 服务器配合使用。更多详情,请参阅架构。
⚠️警告⚠️
转储 RPC 方法(例如dump_render_tree
)可能会导致大量令牌使用或上下文过载。因此,现在默认情况下禁用它们,但可以通过环境变量DUMPS_SUPPORTED=true
启用它们。
有关环境变量的更多详细信息,请参阅.env.example 。
🚀 入门
- 快速入门可在QUICK_START.md中找到
- 配置选项在CONFIGURATION.md中可用
🎯 适用于 AI 代理的工具
错误分析
get_app_errors
[资源|工具] - 从您的 Flutter 应用中检索精确且简明的错误信息用法:- 仅使用简短的错误描述。应过滤重复的错误,以避免 Agent 上下文窗口充斥着相同的错误。
- 使用错误监视器捕获 Dart VM 错误。具体操作如下:首先启动 mcp 服务器、转发服务器,然后启动应用,打开开发者工具和扩展程序,最后重新加载应用,以捕获错误。所有错误都会被捕获到开发者工具扩展程序 (mcp_bridge) 中。
已在以下平台测试:✅ macOS、✅ iOS未在以下平台测试:🚧 Android、🤔 Windows、🤔 Linux、❌ Web查看问题
开发工具
hot_reload
[工具] - 执行 Flutter 应用程序的热重新加载已在以下平台测试:✅ macOS、✅ iOS、✅ Android未在以下平台测试:🤔 Windows、🤔 Linux、❌ Web查看问题screenshot
[资源|工具] - 捕获正在运行的应用程序的屏幕截图。配置:- 使用
--images
标志或IMAGES_SUPPORTED=true
环境变量启用 - 可以使用压缩来优化图像大小
已在以下平台测试:✅ macOS、✅ iOS未在以下平台测试:🚧 Android、🤔 Windows、🤔 Linux、❌ Web查看问题
- 使用
如果未指定端口,所有工具均默认使用端口 8181。您可以提供具体的端口号来覆盖此设置。
📚 请参阅MCP_RPC_DESCRIPTION中的更多内容
🔧 故障排除
get_app_errors
- 由于错误是在 DevTools Extension 中捕获的,因此您需要确保在启动 MCP 服务器、转发服务器和 DevTools mcp_bridge 扩展后重新启动或重新加载 Flutter 应用程序。
还请确保:
- 验证转发服务器是否正在运行。
- 在浏览器中打开 Devtools。
- 已将 MCP 扩展添加到您的 Flutter 应用程序开发依赖项并在 Devtools 中启用它。
- 连接问题
- 确保您的 Flutter 应用在调试模式下运行
- 验证 Flutter 应用和检查器中的端口是否匹配
- 检查端口是否未被其他进程使用
- AI工具未检测到检查员
- 配置更改后重新启动 AI 工具
- 验证配置 JSON 语法
- 检查工具日志中的连接错误
🚧 Smithery 集成🚧(正在进行中)
Flutter Inspector 已在 Smithery 的注册表中注册,因此其他 AI 工具可以通过标准化界面发现和使用它。
集成架构
🤝 贡献
欢迎贡献代码!欢迎在GitHub 仓库提交 Pull 请求或报告问题。
📖 了解更多
📄 许可证
MIT——欢迎在您的项目中自由使用!
Flutter 和 Dart 是 Google LLC 的商标。
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
一个 MCP 服务器,其简单目标是通过赋予 AI 编码助手(例如 Cline、Cursor、Claude 等)工具分析 Widget 树、导航和布局问题的能力来调试 Flutter 应用。请参阅架构图以了解其工作原理:https://github.com/Arenukvern/mcp_flutter/blob/main/ARCHITECTURE.md
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityEnables interaction with the Flutter SDK by providing tools to analyze and apply fixes to Dart and Flutter files.Last updated -23JavaScript
- AsecurityAlicenseAqualityA Dart-based MCP server implementation that enables AI-assisted task management, document handling, and workspace organization through standardized tools and seamless Dart integration.Last updated -107352JavaScriptMIT License
- AsecurityAlicenseAqualityA distributable Model Context Protocol (MCP) server that exposes Dart SDK commands for AI-powered development. This server bridges the gap between AI coding assistants and Dart/Flutter development workflows by implementing the Model Context Protocol (MCP).Last updated -10112TypeScriptMIT License
- -securityFlicense-qualityAn MCP server that provides detailed information about your development environment to the Cursor code editor, enabling more context-aware assistance.Last updated -1Python