flutter-devtools-mcp 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dragan Bajic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,208 @@
+# flutter-devtools-mcp
+
+Connect AI agents to running Flutter apps for runtime inspection, profiling, and debugging through the Dart VM Service Protocol.
+
+```
+┌─────────────────┐     stdio      ┌──────────────────────┐   WebSocket    ┌─────────────────┐
+│  AI Agent       │◄──────────────►│  flutter-devtools-mcp │◄─────────────►│  Flutter App     │
+│ (Cursor/Claude) │                │      (MCP Server)     │   VM Service  │ (debug/profile)  │
+└─────────────────┘                └──────────────────────┘                └─────────────────┘
+```
+
+[中文文档](./README.zh-CN.md)
+
+## 1) Capabilities
+
+- Auto-discover and connect to running Flutter apps
+- Inspect widget tree and locate rebuild hotspots with source references
+- Run session-based performance collection (frames, CPU, memory, network)
+- Save and compare memory snapshots
+- Execute debug actions (hot reload/restart, evaluate expression, screenshot)
+
+## 2) Quick Start
+
+### Prerequisites
+
+- Node.js >= 18
+- A Flutter app running in `debug` or `profile` mode (recommended: `profile`)
+
+### Install and build
+
+```bash
+git clone https://github.com/draganbajic/flutter-devtools-mcp.git
+cd flutter-devtools-mcp
+npm install
+npm run build
+```
+
+### MCP config examples
+
+#### Cursor (`.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "flutter-devtools": {
+      "command": "node",
+      "args": ["/path/to/flutter-devtools-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+#### Claude Desktop (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "flutter-devtools": {
+      "command": "node",
+      "args": ["/path/to/flutter-devtools-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+#### VS Code / Copilot (`.vscode/mcp.json`)
+
+```json
+{
+  "servers": {
+    "flutter-devtools": {
+      "command": "node",
+      "args": ["/path/to/flutter-devtools-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+#### CodeBuddy (`.codebuddy/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "flutter-devtools": {
+      "command": "node",
+      "args": ["/path/to/flutter-devtools-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## 3) Recommended Flow: 30s Session Collection
+
+Start your app:
+
+```bash
+flutter run --profile
+```
+
+Then ask your AI assistant:
+
+```text
+Connect Flutter app, collect performance data for 30s (scenario: home feed scroll), and provide optimization suggestions based on code.
+```
+
+The AI calls `collect_performance_session` (blocking for 30s), then reads `filesToInspect` and returns P0/P1/P2 suggestions.
+
+Design docs:
+
+- Metrics guide: [`docs/performance-metrics-guide.md`](docs/performance-metrics-guide.md)
+- Session design: [`docs/performance-session-simple-design.md`](docs/performance-session-simple-design.md)
+- Doc index: [`docs/README.md`](docs/README.md)
+- Image URL sample: [`examples/app_network_image_README.md`](examples/app_network_image_README.md)
+
+## 4) Regression Commands
+
+```bash
+# Android debug regression
+npm run test:regression:android
+
+# Android profile regression (default duration)
+npm run test:regression:android:profile
+
+# Android profile regression (30s)
+npm run test:regression:android:profile:30s
+```
+
+## 5) Tool List (22)
+
+### Performance Session
+| Tool | Description |
+|------|-------------|
+| `collect_performance_session` | Block for N seconds (default 30), return JSON with frames/rebuilds/CPU/memory/network |
+
+### Discovery & Connection
+| Tool | Description |
+|------|-------------|
+| `discover_apps` | Auto-discover and connect to running Flutter apps |
+| `connect` | Connect by VM Service URI |
+| `disconnect` | Disconnect from current app |
+| `get_app_info` | VM / isolate / platform / extension capability info |
+
+### Widget Inspection
+| Tool | Description |
+|------|-------------|
+| `get_widget_tree` | Widget hierarchy with source locations and project filtering |
+| `inspect_widget` | Deep inspect widget properties/constraints/render info |
+
+### Rebuild Tracking
+| Tool | Description |
+|------|-------------|
+| `start_tracking_rebuilds` | Start rebuild tracking |
+| `stop_tracking_rebuilds` | Rebuild report with counts, source locations, and suggestions |
+
+### Performance Profiling
+| Tool | Description |
+|------|-------------|
+| `start_profiling` | Start timeline profiling |
+| `stop_profiling` | Frame/jank/hotspot/build-layout-paint analysis |
+
+### Memory Analysis
+| Tool | Description |
+|------|-------------|
+| `get_memory_snapshot` | Heap snapshot with class distribution and suspicious allocations |
+| `save_snapshot` | Save named snapshot |
+| `compare_snapshots` | Compare two snapshots |
+| `list_snapshots` | List saved snapshots |
+
+### Network
+| Tool | Description |
+|------|-------------|
+| `start_network_capture` | Start HTTP traffic capture |
+| `stop_network_capture` | URL/status/time/size/error report |
+
+### Debug Actions
+| Tool | Description |
+|------|-------------|
+| `hot_reload` | Trigger hot reload |
+| `hot_restart` | Trigger hot restart |
+| `take_screenshot` | Capture screenshot |
+| `toggle_debug_paint` | Toggle debug paint |
+| `evaluate_expression` | Evaluate Dart expression |
+
+## 6) Recommendations and Limitations
+
+- Prefer `profile` mode for accurate performance metrics: `flutter run --profile`
+- `debug` mode adds overhead; use it for trend checks only
+- Rebuild tracking extension is unavailable in `profile` mode (auto-degraded)
+- Network capture depends on `dart:io` `HttpClient` timeline events
+- `projectTopFunctions` tracks app `lib/` methods; hit rate can be low on Android profile. Use 30~60s collection and active interactions
+- To attribute image decode to a **URL**, use the shared loader sample: [`examples/app_network_image.dart`](./examples/app_network_image.dart) (see [`examples/app_network_image_README.md`](./examples/app_network_image_README.md))
+
+## 7) Roadmap
+
+- [x] Auto-discover running Flutter apps
+- [x] Widget rebuild tracking with source locations
+- [x] Network traffic inspection
+- [x] Before/after snapshot comparison
+- [x] Session-based performance collection (`collect_performance_session`)
+- [ ] Continuous monitoring mode (real-time jank watcher)
+- [ ] Integration test runner with performance baselines
+- [ ] Shader compilation jank detection
+- [ ] npm publish for `npx flutter-devtools-mcp`
+
+## 8) License
+
+MIT
+

package/README.zh-CN.md

@@ -0,0 +1,292 @@
+# flutter-devtools-mcp
+
+连接 AI 助手与运行中的 Flutter App（Dart VM Service），让 AI 可以直接做运行时排查、性能采集和调试分析。
+
+```
+┌─────────────────┐     stdio      ┌──────────────────────┐   WebSocket    ┌─────────────────┐
+│  AI Agent       │◄──────────────►│  flutter-devtools-mcp │◄─────────────►│  Flutter App     │
+│ (Cursor/Claude) │                │      (MCP Server)     │   VM Service  │ (debug/profile)  │
+└─────────────────┘                └──────────────────────┘                └─────────────────┘
+```
+
+[English](./README.md)
+
+## 1. 你能用它做什么
+
+- 自动发现并连接 Flutter 进程（无需手抄 VM URI）
+- 查看 Widget 树、定位重建热点（含源码位置）
+- 采集性能会话（帧、CPU、内存、网络）并输出结构化结果
+- 做快照对比（内存前后变化）
+- 执行调试动作（hot reload/restart、表达式求值、截图等）
+
+
+
+## 2. 快速开始
+
+
+
+### 2.1 前置条件
+
+- Node.js >= 18
+- Flutter App 运行在 `debug` 或 `profile` 模式（建议 `profile`）
+
+
+
+### 2.2 安装与构建
+
+```bash
+git clone https://github.com/draganbajic/flutter-devtools-mcp.git
+cd flutter-devtools-mcp
+npm install
+npm run build
+```
+
+
+
+### 2.3 MCP 配置
+
+
+
+#### Cursor (`.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "flutter-devtools": {
+      "command": "node",
+      "args": ["/path/to/flutter-devtools-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+
+
+#### Claude Desktop (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "flutter-devtools": {
+      "command": "node",
+      "args": ["/path/to/flutter-devtools-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+
+
+#### VS Code / Copilot (`.vscode/mcp.json`)
+
+```json
+{
+  "servers": {
+    "flutter-devtools": {
+      "command": "node",
+      "args": ["/path/to/flutter-devtools-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+
+
+#### CodeBuddy (`.codebuddy/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "flutter-devtools": {
+      "command": "node",
+      "args": ["/path/to/flutter-devtools-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+
+
+## 3. 推荐主流程：30s 性能会话
+
+先启动 App：
+
+```bash
+flutter run --profile
+```
+
+然后在 AI 中直接说：
+
+```text
+连接 Flutter App，开始采集性能数据 30s，场景：首页滚动，结合代码给优化方案
+```
+
+AI 会调用 `collect_performance_session`（阻塞 30s）并返回结构化结果，随后结合 `filesToInspect` 源码给出 P0/P1/P2 优化建议。
+
+**文档：**
+
+- 指标怎么读（GC / 重建 / 图片解码等）：`[docs/performance-metrics-guide.md](docs/performance-metrics-guide.md)`
+- 产品与数据结构：`[docs/performance-session-simple-design.md](docs/performance-session-simple-design.md)`
+- 文档索引：`[docs/README.md](docs/README.md)`
+- 图片 URL 埋点样板：`[examples/app_network_image_README.md](examples/app_network_image_README.md)`
+
+
+
+## 4. 回归命令
+
+```bash
+# Android debug 回归
+npm run test:regression:android
+
+# Android profile 回归（默认时长）
+npm run test:regression:android:profile
+
+# Android profile 回归（30s）
+npm run test:regression:android:profile:30s
+```
+
+
+
+## 5. 工具清单（22）
+
+
+
+### Performance Session
+
+
+| Tool                          | Description                                                                                                   |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `collect_performance_session` | 阻塞采集 N 秒（默认 30），返回 JSON：帧/jank、耗时函数（Self>20ms 异常）、重建（debug）、GC、滚动FPS、图片解码、Isolate、内存、网络；并生成带「开发者结论」的 `.ai.md` |
+
+
+
+
+### Discovery & Connection
+
+
+| Tool            | Description                 |
+| --------------- | --------------------------- |
+| `discover_apps` | 自动发现并连接运行中的 Flutter App     |
+| `connect`       | 通过 VM Service URI 手动连接      |
+| `disconnect`    | 断开连接                        |
+| `get_app_info`  | 获取 VM / isolate / 平台信息与扩展能力 |
+
+
+
+
+### Widget Inspection
+
+
+| Tool              | Description                 |
+| ----------------- | --------------------------- |
+| `get_widget_tree` | 获取 Widget 层级（含源码位置与项目过滤）    |
+| `inspect_widget`  | 深度查看 widget 属性/约束/render 信息 |
+
+
+
+
+### Rebuild Tracking
+
+
+| Tool                      | Description        |
+| ------------------------- | ------------------ |
+| `start_tracking_rebuilds` | 开始追踪重建             |
+| `stop_tracking_rebuilds`  | 输出重建报告（次数、源码位置、建议） |
+
+
+
+
+### Performance Profiling
+
+
+| Tool              | Description                            |
+| ----------------- | -------------------------------------- |
+| `start_profiling` | 开始 timeline profiling                  |
+| `stop_profiling`  | 输出帧、jank、hotspot、build/layout/paint 分析 |
+
+
+
+
+### Memory Analysis
+
+
+| Tool                  | Description      |
+| --------------------- | ---------------- |
+| `get_memory_snapshot` | 获取堆快照（含类分布、疑似异常） |
+| `save_snapshot`       | 保存命名快照           |
+| `compare_snapshots`   | 对比两个快照差异         |
+| `list_snapshots`      | 列出所有快照           |
+
+
+
+
+### Network
+
+
+| Tool                    | Description            |
+| ----------------------- | ---------------------- |
+| `start_network_capture` | 开始抓取 HTTP 流量           |
+| `stop_network_capture`  | 输出 URL、状态码、耗时、体积、错误等统计 |
+
+
+
+
+### Debug Actions
+
+
+| Tool                  | Description    |
+| --------------------- | -------------- |
+| `hot_reload`          | 触发 Hot Reload  |
+| `hot_restart`         | 触发 Hot Restart |
+| `take_screenshot`     | 截图             |
+| `toggle_debug_paint`  | 切换 Debug Paint |
+| `evaluate_expression` | 执行 Dart 表达式    |
+
+
+
+
+## 6. 使用建议与限制
+
+- 推荐在 `profile` 模式采集性能数据：`flutter run --profile`
+- `debug` 有额外检查开销，性能数据仅供趋势参考
+- `profile` 下不支持 Widget 重建追踪扩展（会自动降级）
+- 网络采集基于 `dart:io` `HttpClient` timeline 事件，部分第三方实现可能无法完整采集
+- `projectTopFunctions` 为业务 `lib/` 方法列表，Android profile 下命中率可能偏低，建议 30~60s 并持续业务交互
+- 图片解码若要带 **URL/尺寸**，请业务侧使用统一入口样板：`[examples/app_network_image.dart](./examples/app_network_image.dart)`（说明见 `[examples/app_network_image_README.md](./examples/app_network_image_README.md)`）
+
+
+
+## 7. 路线图
+
+- [x] 自动发现并连接运行中的 Flutter 应用
+- [x] 支持带源码位置的 Widget 重建追踪
+- [x] 支持网络流量检查
+- [x] 支持前后快照对比
+- [x] 支持会话式性能采集（`collect_performance_session`）
+- [ ] 持续监控模式（实时卡顿监视）
+- [ ] 集成测试运行器（含性能基线对比）
+- [ ] Shader 编译卡顿检测
+- [x] 发布到 npm（支持 `npx flutter-devtools-mcp`）
+
+
+
+## 8. 发版（GitHub Actions → npm）
+
+1. 仓库 Settings → Secrets and variables → Actions，新增 **`NPM_TOKEN`**（[npm Access Tokens](https://www.npmjs.com/settings/~/tokens) 选 Automation）
+2. 改版本并提交：
+   ```bash
+   cd flutter-devtools-mcp
+   npm version patch   # 0.3.0 → 0.3.1，会改 package.json 并打 git tag
+   git push origin main --tags
+   ```
+3. GitHub → **Releases** → Draft a new release，Tag 选刚推的 `v0.3.1` → Publish  
+   → 自动跑 [`.github/workflows/publish-npm.yml`](../.github/workflows/publish-npm.yml) 发布到 npmjs.com  
+   也可在 Actions 里对 **Publish npm** 点 Run workflow 手动触发。
+
+> Tag 版本（去掉前缀 `v`）必须与 `package.json` 的 `version` 一致。
+
+
+
+## 9. License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { FlutterVmServiceClient } from "./services/vm-service-client.js";
+import { Profiler } from "./services/profiler.js";
+import { registerConnectionTools } from "./tools/connection.js";
+import { registerWidgetTreeTools } from "./tools/widget-tree.js";
+import { registerProfilingTools } from "./tools/profiling.js";
+import { registerMemoryTools } from "./tools/memory.js";
+import { registerDebugActionTools } from "./tools/debug-actions.js";
+import { registerRebuildTrackerTools } from "./tools/rebuild-tracker.js";
+import { registerDiscoverTools } from "./tools/discover.js";
+import { registerNetworkTools } from "./tools/network.js";
+import { registerSnapshotDiffTools } from "./tools/snapshot-diff.js";
+import { RebuildTrackerService } from "./services/rebuild-tracker-service.js";
+import { NetworkCaptureService } from "./services/network-capture-service.js";
+import { CpuProfilerService } from "./services/cpu-profiler-service.js";
+import { PerformanceSession } from "./services/performance-session.js";
+import { registerPerformanceSessionTools } from "./tools/performance-session.js";
+const server = new McpServer({
+    name: "flutter-devtools-mcp",
+    version: "0.3.0",
+});
+const vmClient = new FlutterVmServiceClient();
+const profiler = new Profiler(vmClient);
+const rebuildTracker = new RebuildTrackerService(vmClient);
+const networkCapture = new NetworkCaptureService(vmClient);
+const cpuProfiler = new CpuProfilerService(vmClient);
+const performanceSession = new PerformanceSession(vmClient, profiler, rebuildTracker, networkCapture, cpuProfiler);
+registerDiscoverTools(server, vmClient);
+registerConnectionTools(server, vmClient);
+registerWidgetTreeTools(server, vmClient);
+registerProfilingTools(server, vmClient, profiler);
+registerMemoryTools(server, vmClient);
+registerRebuildTrackerTools(server, vmClient);
+registerNetworkTools(server, vmClient);
+registerSnapshotDiffTools(server, vmClient);
+registerDebugActionTools(server, vmClient);
+registerPerformanceSessionTools(server, performanceSession);
+vmClient.on("error", (err) => {
+    console.error("[flutter-devtools-mcp] VM Service error:", err);
+});
+vmClient.on("disconnected", () => {
+    console.error("[flutter-devtools-mcp] Disconnected from Flutter app VM Service");
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[flutter-devtools-mcp] Server started on stdio transport");
+}
+main().catch((err) => {
+    console.error("[flutter-devtools-mcp] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/services/ai-analysis.d.ts

@@ -0,0 +1,6 @@
+import { type PerformanceSessionResult } from "./session-types.js";
+export interface AiAnalysisOptions {
+    projectRoot?: string;
+}
+export declare function generateAiAnalysis(result: PerformanceSessionResult, options?: AiAnalysisOptions): Promise<string>;
+//# sourceMappingURL=ai-analysis.d.ts.map

package/dist/services/ai-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-analysis.d.ts","sourceRoot":"","sources":["../../src/services/ai-analysis.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAkB5B,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2cD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,EAChC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA8ZjB"}