flutter mcp工具包
_从您的AI助手检查并驱动正在运行的Flutter应用程序。_
flutter-mcp-toolkit 是一个Dart MCP服务器+Flutter包，允许AI代理（Codex、Zed、Cursor、Intent、Claude Code、Cline等）拍摄（语义快照、点击小部件、键入表单、热重新加载和从Flutter应用程序读取日志）或创建 __运行时它自己的工具和资源__ 使用MCP Toolkit——无需离开对话，在闭环反馈循环中使用Flutter应用程序——请参阅中描述的示例 OpenAI代理工具.
通过4个步骤开始
# 1. Install the binary
curl -fsSL https://raw.githubusercontent.com/Arenukvern/mcp_flutter/main/install.sh | bash
# 2. Add the toolkit to your Flutter app
cd my-flutter-app
flutter-mcp-toolkit codegen-init # adds flutter_mcp_toolkit + emits main.dart snippet
# 3. Install skills for your AI agent
flutter-mcp-toolkit init claude-code # or: cursor | codex | cline | all
# 4. Run
flutter run --debug就是这样。你的AI代理现在可以检查和驱动正在运行的应用程序。
文档
- AI Agent和人类文档 -wiki+llms.txt
- 迁移v2→ v3 —
fmt_*MCP工具、二进制文件、客户端配置密钥，validate-runtime. - 为什么这个回购很重要 --它是什么，为什么存在。
- CLI与MCP --选择正确的模式。
- 特征图 --27种工具。
- AI代理设置 -AI代理。
- 建筑 --对于贡献者。
- 快速开始, 配置, MCP RPC说明
它做什么
该工具包公开了27个MCP工具（在 fmt_* 能力前缀）跨越四个类别：
- 检查 --语义快照、查看详细信息、错误、屏幕截图、VM信息
- 交互 --点击、滚动、键入、填写表单、热重新加载、导航、等待
- 调试 --最近的日志，计算Dart表达式
- 生命周期 --发现应用程序、热重新加载、热重启
看 flutter-mcp-toolkit-{guide,inspect,control,debug} 全面的技能 参考（由安装 flutter-mcp-toolkit init).
动态工具注册
Flutter应用程序可以在运行时注册自定义工具和资源。看看如何 在这方面工作 YouTube短视频. 相同 arguments.connection CLI支持目标定位 exec, batch，守护进程 command/execute，守护进程 watch/start，以及快照步骤参数。
\[！注意\] 有官方 Flutter团队的Flutter MCP服务器 这暴露了Dart工具。
⚠️ 关于倾倒RPC的说明
转储RPC方法（如 dump_render_tree)可以产生巨大的代币输出 默认情况下禁用。启用 --dumps。参见 mcp_server_dart自述文件 整个国旗表面。
🔒 安全
通常，由于您在调试模式下使用MCP服务器连接到Flutter应用程序，因此使用它应该是安全的。但是，我仍然建议查看它在 建筑.md，如果需要，如何修改它以提高安全性。
此MCP服务器由以下人员验证 艾女士.
🔧 故障排除
- 连接问题
- 确保Flutter应用程序在调试模式下运行 - 验证Flutter应用程序和MCP服务器中的端口是否匹配 - 检查该端口是否未被其他进程使用 - 最安全的明确目标：使用 arguments.connection.uri 并粘贴精确的Flutter机器 app.debugPort.wsUri - 如果响应包括 connection_selection_required，请重试 arguments.connection.targetId 使用一个URI availableTargets （或设置 arguments.connection.uri 直接）
- AI工具未检测到检查器
- 配置更改后重新启动AI工具 - 验证配置JSON语法 - 检查工具日志中的连接错误
- 动态工具未出现
- 确保 flutter_mcp_toolkit 包已在Flutter应用程序中正确初始化 - 检查工具是否已使用注册 MCPToolkitBinding.instance.addEntries() - 使用 fmt_list_client_tools_and_resources 验证注册 - 添加新工具后热重新加载Flutter应用程序
Flutter MCP服务器已在Smithery的注册表中注册，使其能够通过标准化的接口被其他AI工具发现和使用。
集成架构
┌─────────────────┐ ┌───────────────────────┐ ┌─────────────────┐
│ │ │ Flutter App with │ │ │
│ Flutter App ││ flutter_mcp_toolkit ││ flutter-mcp- │
│ (Debug Mode) │ │ (VM Svc. Extensions │ │ toolkit-server │
│ │ │ + Dynamic Tools) │ │ │
└─────────────────┘ └───────────────────────┘ └─────────────────┘🤝 贡献
欢迎投稿！请随时提交拉取请求或报告问题 .
✨ 贡献者
非常感谢所有贡献者让这个项目变得更好！
Henry Mao 🚇
Marwen 📖
Lawrence Sinclair 📖 🛡️
Frank Fiegel 🚇
Harish Anbalagan 📓 🐛
Torben Keller 📓 🐛
Isfun 📓 🐛 🔬 💻
Cosy Studio 📓 🐛 🔬
Luke Memet 📓 🔬 🚧 ✅
Commentatk Media 💻 🚧 📖
Umit Arslan 💻 🚧
Joel Kitching 💻 🚧
Jean-Luc Thumm 🚧
Miguel Casagrande 💻 🚧
📖 了解更多
明星历史
📄 许可证
麻省理工学院 -欢迎在您的项目中使用！
______________________________________________________________________
_Flutter和Dart是Google LLC的商标。_