---
name: dart-mcp-tools
description: Dart/Flutter MCP tools reference for app lifecycle, hot reload/restart, logging, widget inspection, and code analysis. Use when debugging Flutter applications.
---

# 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` でソースコード位置を特定