Flutter Tools MCP Server 使用说明

项目简介

'flutter-tools' MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 LLM 客户端提供 Flutter 和 Dart 开发相关的工具。它集成了 Flutter SDK 的分析和修复能力，允许开发者通过 MCP 客户端调用工具来检查代码问题并自动应用修复建议。

主要功能点

代码诊断 (get_diagnostics): 分析指定的 Dart 或 Flutter 代码文件，返回详细的诊断信息，例如错误、警告等。这有助于开发者快速了解代码中的潜在问题。
自动修复 (apply_fixes): 对指定的 Dart 或 Flutter 代码文件应用 Flutter SDK 提供的自动修复建议。这可以帮助开发者快速解决代码中的常见问题，提升开发效率。

安装步骤

该 MCP Server 本身无需单独安装，您只需要确保满足以下条件：

安装 Flutter SDK: 确保您的开发环境中已经安装了 Flutter SDK，并且 'flutter' 命令可以从命令行访问。
配置 MCP 客户端: 您需要在您的 MCP 客户端中配置 'flutter-tools' MCP Server 的相关信息，以便客户端能够连接和使用该服务器提供的工具。

服务器配置

在您的 MCP 客户端配置文件中（通常是 JSON 格式），添加以下服务器配置信息。这会告诉 MCP 客户端如何启动和连接 'flutter-tools' MCP Server。

{
  "mcpServers": {
    "flutter-tools": {
      "command": "node",
      "args": ["/path/to/flutter-tools/build/index.js"],
      "env": {},
      "name": "flutter-tools" // (可选) 服务器名称，建议与配置名保持一致，方便识别
    }
  }
}

配置参数说明:

'server name': 'flutter-tools' - 服务器的名称，用于在 MCP 客户端中唯一标识该服务器。
'command': 'node' - 启动服务器的命令，这里使用 Node.js 运行时环境来执行 JavaScript 代码。
'args': '["/path/to/flutter-tools/build/index.js"]' - 传递给 'command' 的参数，指定了 'flutter-tools' MCP Server 编译后的入口文件路径。请务必将 '/path/to/flutter-tools/build/index.js' 替换为实际的 'flutter-tools' 仓库 'build/index.js' 文件的绝对路径。
'env': '{}' - 环境变量配置，当前配置为空，您可以根据需要添加环境变量。

基本使用方法

启动 MCP 客户端: 确保您的 MCP 客户端已正确配置并启动。客户端会自动根据配置启动 'flutter-tools' MCP Server。

调用工具: 在 MCP 客户端中，您可以使用 'flutter-tools' 服务器提供的 'get_diagnostics' 和 'apply_fixes' 工具。

例如，要使用 'get_diagnostics' 工具分析文件 '/path/to/your/file.dart'，您可以在 MCP 客户端中构造并发送如下的调用工具请求 (CallToolRequest)：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "MCP.callTool",
  "params": {
    "serverName": "flutter-tools", // 指定要调用的 MCP 服务器名称
    "toolName": "get_diagnostics", // 指定要调用的工具名称
    "arguments": {
      "file": "/path/to/your/file.dart" // 工具的参数，这里是 Dart 文件路径
    }
  }
}

服务器会将诊断结果以 JSON 格式返回给客户端。

使用 'apply_fixes' 工具的方法类似，只需将 'toolName' 修改为 'apply_fixes'，并提供相应的 'file' 参数。

注意: 'flutter-tools' MCP Server 依赖于 Flutter SDK，请确保您的环境中 Flutter SDK 配置正确，并且 'flutter' 命令可以正常运行。

关键词