Dart MCP Tools

Dart/Flutter開発向けMCPツールリファレンス。

Device Management

| Tool | Purpose | |------|---------| | mcp__dart__list_devices | 利用可能なデバイス/シミュレーター/エミュレーターを一覧表示 | | mcp__dart__list_running_apps | 実行中のFlutterアプリを一覧表示 |

App Lifecycle

| Tool | Purpose | |------|---------| | mcp__dart__launch_app | Flutterアプリをデバイスで起動 | | mcp__dart__stop_app | 実行中のFlutterアプリを停止 | | mcp__dart__hot_reload | Hot reload（状態を維持してコード反映） | | mcp__dart__hot_restart | Hot restart（状態をリセットして再起動） |

Debugging & Logs

| Tool | Purpose | |------|---------| | mcp__dart__get_app_logs | アプリケーションログを取得 | | mcp__dart__get_runtime_errors | ランタイムエラーを取得 | | mcp__dart__connect_dart_tooling_daemon | Dartツーリングデーモンに接続 |

Widget Inspection

| Tool | Purpose | |------|---------| | mcp__dart__get_widget_tree | Widgetツリー構造を取得 | | mcp__dart__get_selected_widget | 選択中Widgetの詳細を取得 | | mcp__dart__set_widget_selection_mode | Widget選択モードを有効化 | | mcp__dart__get_active_location | アクティブなコード位置を取得 |

Code Quality

| Tool | Purpose | |------|---------| | mcp__dart__analyze_files | Dart analyzerを実行 | | mcp__dart__dart_fix | 自動修正を適用 | | mcp__dart__run_tests | テストを実行 |

---

Typical Workflow

1. mcp__dart__list_devices        # デバイス確認
2. mcp__dart__launch_app          # アプリ起動
3. (コード変更)
4. mcp__dart__hot_restart         # 再起動
5. mcp__dart__get_app_logs        # ログ取得
6. 分析・修正・繰り返し

---

Tips

Hot Reload vs Hot Restart

| Hot Reload | Hot Restart | |------------|-------------| | UI変更、レイアウト調整 | initState変更、状態クラス変更 | | 状態維持 | クリーンな状態でテスト | | 高速 | やや遅い |

Log Capture

1. hot_restart で古いログをクリア
2. 1アクションを実行
3. 即座に get_app_logs で取得
4. ノイズが少なく分析しやすい

Widget Tree Debugging

1. set_widget_selection_mode で選択モード有効化
2. デバイス上でWidgetをタップ
3. get_selected_widget で詳細取得
4. get_active_location でソースコード位置を特定