Flutter Maestro MCP

🚀 Flutter Maestro MCP Server

実験的なモデルコンテキストプロトコル（MCP）サーバーで、AIエージェントがVMサービスを介して実行中のFlutterアプリケーションと対話し、Maestroフローを実行できるようにします。カスタムMCPを試すためだけのものです。

🚀 クイックスタート

このサーバーを使用することで、AIエージェントがFlutterアプリとやり取りし、Maestroフローを実行できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• AIエージェントがVMサービスを通じてFlutterアプリと対話することを可能にします。
• Maestroフローを実行できます。
• 様々なツールを提供し、Flutterアプリとのやり取りをサポートします。

📦 インストール

前提条件

• Maestro CLI：run_maestro_flowツールでMaestroフローを実行するために必要です。
  • Homebrewを通じてインストール：brew install maestro
  • または公式インストールガイドに従ってください。

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールするためにdart pub getを実行します。

📚 ドキュメント

設定

VS Code

MCP設定ファイル（通常は~/.vscode/mcp.jsonまたは拡張機能によって異なります）に以下を追加します。

{
  "servers": {
    "flutter-maestro": {
      "command": "dart",
      "args": [
        "/absolute/path/to/flutter_maestro_mcp/bin/flutter_maestro_mcp.dart"
      ]
    }
  }
}

注意：/absolute/path/to/flutter_maestro_mcpをクローンしたリポジトリの実際のパスに置き換えてください。

サンプルアプリでのテスト

このリポジトリには、MCPサーバーの機能を検証するためのテストフックが設定されたサンプルのFlutterアプリケーションが含まれています。

VS Codeを使用する場合（推奨）：

1. VS Codeでリポジトリを開きます。
2. 実行とデバッグに移動し、**"Flutter Example App"**を選択します。
3. デバッグコンソールからVMサービスURIをコピーします。

コマンドラインを使用する場合：

1. example/に移動します。
2. アプリを実行：flutter run
3. 出力からVMサービスURIをメモします（例：ws://127.0.0.1:12345/ws）

実行中の場合：

1. Flutterアプリの出力から完全なVMサービスURIをコピーします。
2. このURIでconnectツールを使用します。
3. inspect_uiやtapなどのツールを使って、実行中のサンプルアプリと対話してみましょう。

VMサービスURIを見つける方法： Flutterアプリが起動するとVMサービスURIが表示されます。認証トークンを含む完全なURIをコピーする必要があります。

• VS Codeデバッグコンソール："VM Service"または"Observatory"を検索します。
• Flutter CLI出力："The Dart VM service is listening on ws://..."を探します。
• URI形式：ws://127.0.0.1:PORT/AUTH_TOKEN/ws
• 例：ws://127.0.0.1:59548/-ppep2G-MyI=/ws

⚠️ 重要な注意

自動検出はサポートされていません。認証トークンを含む完全なURIを指定する必要があります。トークンはアプリ起動時に1回だけ表示され、後から取得することはできません。

利用可能なツール

• connect：VMサービスURIを使用して実行中のFlutterアプリに接続します。
  • 引数：uri（必須 - Flutterアプリの出力からの認証トークンを含む完全なVMサービスWebSocket URI、例：ws://127.0.0.1:59548/-ppep2G-MyI=/ws）
• disconnect：現在のFlutterアプリから切断します。
• inspect_ui：現在のUI階層（キー、テキスト、セマンティクス）の簡略化されたJSON表現を取得します。
• tap：条件に一致するウィジェットをタップします。
  • 引数：key, text, tooltip, semantics
• enter_text：条件に一致するウィジェットにテキストを入力します。
  • 引数：input（必須）、およびマッチャー引数（key, textなど）
• scroll_to：ウィジェットが表示されるまでスクロールします。
  • 引数：マッチャー引数（key, textなど）
• take_screenshot：現在の画面のスクリーンショットを撮ります。
• get_logs：アプリケーションのログを取得します。
• hot_reload：ホットリロードをトリガーします。
• write_maestro_flow：Maestro YAMLフローをファイルに書き込みます。
  • 引数：path, content
• run_maestro_flow：maestro testを使用してMaestro YAMLフローを実行します。
  • 引数：path