🎯 Dart & Flutter MCP 安装经验分享

最近在使用 Flutter 开发移动端应用，因此需要安装 Dart & Flutter MCP 来辅助进行代码分析与问题排查。

按照 Google 官方文档进行安装时，出现以下错误：

1 2	✖ MCP ERROR (dart): Error: spawn dart ENOENT ✖ Error during discovery for server 'dart': spawn dart ENOENT

该错误通常表示系统无法找到 dart 可执行文件，常见原因是 Dart SDK 未安装或环境变量未正确配置。

定位 Dart SDK 的安装路径

我在排查后确认 Dart 已安装（我是在 IDE（TRAE）中安装 Flutter 时附带安装了 Dart SDK），但环境变量未配置好。通过查找 Dart SDK 安装目录，定位到 dart-sdk 的路径。

如果 Dart 是随 Flutter 安装的（Flutter 内置 Dart SDK），路径在 Flutter 安装目录的 bin/cache/dart-sdk 下，格式为：/Users/你的用户名/flutter/bin/cache/dart-sdk（其中 /Users/你的用户名/flutter 是你的 Flutter 安装路径）。

配置环境变量

我使用的是 macOS ，因此需要将 Dart SDK 的路径加入 PATH 环境变量。编辑 ~/.zshrc（如果没有该文件，可新建），并添加以下内容：

1	export PATH="$PATH:$HOME/flutter/bin/cache/dart-sdk/bin"

保存文件并执行 source ~/.zshrc 使配置生效。（如未使用默认路径，请替换为实际安装路径。）

验证配置

在新的终端窗口执行 dart --version。如果能正常显示 Dart 版本信息，则说明配置成功。

重新配置 Flutter & Dart MCP

我使用 MCP Router 统一管理所有 MCP 服务器的配置，因此重新添加了 Dart 服务器的配置：

{
  "mcpServers": {
    "dart": {
      "command": "dart",
      "args": ["mcp-server", "--force-roots-fallback"]
    }
  }
}

重新在 MCP Router 开启 Flutter & Dart MCP 后，问题得到解决。

Dart & Flutter MCP 安装演示

其他参考文档

Dart & Flutter MCP 官方文档. Dart.dev. https://dart.dev/tools/mcp-server （访问日期：2025-10-15）
Dart & Flutter MCP Git 文档. GitHub - dart-lang/ai. https://github.com/dart-lang/ai/tree/main/pkgs/dart_mcp_server （访问日期：2025-10-15）