# Dart 与 Flutter MCP 服务器

由 Flutter 团队官方推出的 Dart 与 Flutter MCP 服务器。它将 Claude 和 Cursor 等 AI 编程助手连接到你的 Dart/Flutter 项目中，支持通过自然语言指令进行代码分析、运行 Flutter CLI 工具、调试以及与运行中的应用进行交互。

Canonical URL: https://a2a-mcp.org/entry/flutter-mcp-zh

Language: zh

Category: MCP Servers

Updated: 2026-04-01

## 概述

**Dart 和 Flutter MCP 服务器** 是 Model Context Protocol (MCP) 的官方实现，由谷歌的 Dart 和 Flutter 团队开发和维护。它允许 AI 编程助手（例如 Claude、Cursor、Gemini CLI 及其他工具）深度与您的 Dart 和 Flutter 开发环境进行交互。

该服务器要求 Dart SDK 3.9+ 或 Flutter 3.35+，它提供了强大的工具，让 AI 能够直接访问项目上下文、CLI 命令、分析器结果，甚至正在运行的应用程序——使其成为目前最先进的官方 MCP 集成方案之一。

## 主要特性

- **项目与代码分析**：深入洞察您的代码库、依赖关系、组件树和结构。
- **Flutter CLI 集成**：运行诸如 `flutter pub get`、`flutter analyze`、`flutter test`、`flutter format` 等命令。
- **实时应用交互**：连接到正在运行的 Flutter 应用，以获取屏幕截图、检查组件、进行热重载/重启以及状态调试。
- **类 DevTools 的能力**：访问通常仅在 IDE 或 Flutter DevTools 中可用的工具。
- **实验性但积极开发**：基于社区反馈持续改进。
- **Stdio 传输支持**：适用于所有主要的 MCP 客户端。

## 使用场景

- **AI 辅助开发**：借助完整的项目上下文，请您的 AI “修复这个布局错误”、“添加深色模式支持”或“优化这个组件”。
- **调试与问题排查**：询问“为什么这个屏幕在 Android 上崩溃？”或“捕获当前 UI 状态的屏幕截图”。
- **快速功能构建**：通过对话生成新界面、重构代码或运行测试。
- **学习 Flutter**：即使是初学者，也能在构建应用时获得指导帮助。
- **端到端工作流**：与其他 MCP 服务器结合，实现由 AI 编排的完整移动端开发。

## 安装与设置

### 先决条件
- Dart SDK 3.9+ 或 Flutter 3.35+（建议使用 Beta 或 Stable 渠道）。

### 使用 Cursor 或 Claude 快速设置
大多数现代 AI 客户端都支持轻松添加。对于 Cursor，许多用户只需使用内置的“添加 MCP 服务器”流程并指向官方仓库即可。

对于 Claude Code 或手动配置，请使用 stdio 传输：

```bash
claude mcp add dart -- dart mcp-server
```

或将其添加到客户端配置中（以 Cursor/Claude Desktop 为例）：

```json
{
  "mcpServers": {
    "dart-flutter": {
      "command": "dart",
      "args": ["mcp-server"]
    }
  }
}
```

详细的设置说明可在 [官方 Flutter 文档](https://docs.flutter.dev/ai/mcp-server) 和仓库 README 中找到。

## 热门社区补充工具

虽然官方服务器是推荐的起点，但社区也构建了优秀的扩展：
- **mcp_flutter** (Arenukvern) —— 从正在运行的 Flutter 应用中动态注册工具。
- **flutter-mcp** (adamsmaka) —— 实时 Flutter/Dart 文档和 pub.dev 包搜索。
- **Marionette MCP** —— 用于测试的运行时 UI 交互（点击、滚动、屏幕截图）。

## 兼容性

- **客户端**：Cursor、Claude Desktop/Code、Gemini CLI、GitHub Copilot 以及任何兼容 stdio 的 MCP 客户端。
- **许可证**：开源（属于官方 Dart/Flutter 生态系统的一部分）。

这款官方 MCP 服务器极大降低了 AI 增强 Flutter 开发的门槛，并彰显了 Flutter 团队对 2026 年智能体化 AI 工作流程的坚定承诺。

## Tags

- Flutter
- Dart
- MCP
- 官方
- AI集成
- Claude
- Cursor
- 开发者工具
- Flutter开发

## Sources

- [Project website](https://github.com/dart-lang/ai/tree/main/pkgs/dart_mcp_server)