MCP 服务端 + Flutter MCP 工具包

赋能AI驱动开发

smithery认证徽章 MseeP认证

🔍 模型上下文协议(MCP)服务端，将您的Flutter应用与Cursor、Claude、Cline、Windsurf、RooCode等AI编程助手或任何支持MCP服务端的AI助手连接

查看截图

📖 文档

[!注意] Flutter团队官方提供了Flutter版MCP服务端，用于暴露Dart工具链。

本项目的主要目标是通过在Flutter应用中创建工具，利用动态MCP工具注册机制来发挥MCP服务端工具的威力。观看短视频了解工作原理。详见快速入门。查看项目初衷。

次要目标是优化开发中实用的工具（特别针对AI助手优化，例如：不仅返回错误信息，还会提示AI如何处理该错误）详见MCP_RPC说明文档

欢迎在issue中分享您的反馈和建议！

希望能对您有所帮助，

祝您愉快！

与官方Dart MCP服务端的主要区别：

动态工具注册：Flutter应用可向MCP服务端注册自定义工具。观看短视频演示。详见动态工具注册文档

🎉 v2.5.0版本发布！🎉

新增工具：hot_restart_flutter 支持通过MCP执行VM服务热重启
新增带命名空间服务发现回退机制的VM服务集成方法hotRestart()

特别感谢CommentakMedia提交的热重启工具和文档PR！https://github.com/Arenukvern/mcp_flutter/pull/67

详情参见更新日志。

⚠️ 警告

转储类RPC方法（如dump_render_tree）可能消耗大量token或导致上下文过载。默认已禁用这些方法，但可通过--dumps标志启用。

命令行选项详情参见mcp_server_dart说明文档。

🚀 快速开始

(实验性)可尝试让AI助手安装配置MCP服务端。使用提示词：请通过此链接安装MCP服务端：https://github.com/Arenukvern/mcp_flutter/blob/main/llm_install.md
配合Cursor使用：https://www.youtube.com/watch?v=pyDHaI81uts
配合VSCode+Cline使用：输入提示词请通过此链接安装MCP服务端：https://github.com/Arenukvern/mcp_flutter/blob/main/llm_install.md
快速入门指南
配置选项

🎯 AI助手工具集

核心Flutter工具

get_app_errors [资源|工具] - 获取Flutter应用的精确压缩版错误信息 使用说明：
- 仅使用错误简短描述，自动过滤重复错误避免淹没AI上下文窗口
- 通过错误监控器捕获Dart VM错误，所有错误都可在MCP服务端查询
测试平台： ✅ macOS，✅ iOS 未测试平台： 🚧 Android，🤔 Windows，🤔 Linux，❌ Web 相关issue
view_screenshot [资源|工具] - 捕获运行中应用的屏幕截图 配置项：
- 需启用--images标志
- 使用PNG压缩优化图片体积
get_view_details [资源|工具] - 获取屏幕尺寸、像素比例等视图详情，支持控件选择功能

动态工具注册 🆕

动态注册特性： Flutter应用可运行时注册自定义工具和资源。观看短视频演示。详见动态工具注册文档。

所有工具默认使用8181端口，可通过指定端口号覆盖。

📚 更多功能参见MCP_RPC说明文档

🔒 安全说明

由于MCP服务端仅连接调试模式的Flutter应用，使用基本安全。但仍建议查阅架构文档了解工作原理，必要时可修改提升安全性。

本MCP服务端已通过MseeP.ai安全认证。

🔧 故障排查

连接问题
- 确保Flutter应用处于调试模式
- 检查端口号是否匹配
- 确认端口未被其他进程占用
AI工具无法检测检查器
- 修改配置后重启AI工具
- 验证配置JSON语法
- 检查工具日志中的连接错误
动态工具未显示
- 确认Flutter应用正确初始化mcp_toolkit包
- 检查是否通过MCPToolkitBinding.instance.addEntries()注册工具
- 使用listClientToolsAndResources验证注册状态
- 添加新工具后执行热重载

本Flutter MCP服务端已在Smithery注册中心注册，其他AI工具可通过标准化接口发现和使用。

集成架构

┌─────────────────┐     ┌───────────────────────┐     ┌─────────────────┐
│                 │     │  集成mcp_toolkit的    │     │                 │
│  Flutter应用    │<--->│  Flutter应用 (VM服务   │<--->│ Dart版MCP服务端 │
│  (调试模式)     │     │  扩展+动态工具注册)   │     │                 │
│                 │     │                       │     │                 │
└─────────────────┘     └───────────────────────┘     └─────────────────┘