flutter-devtools-mcp 0.3.1

package/dist/tools/network.js

@@ -0,0 +1,265 @@
+import { z } from "zod";
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    const units = ["B", "KB", "MB"];
+    const k = 1024;
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(1)} ${units[i]}`;
+}
+function formatDuration(ms) {
+    if (ms < 1)
+        return "<1ms";
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    return `${(ms / 1000).toFixed(2)}s`;
+}
+export function registerNetworkTools(server, client) {
+    let capturing = false;
+    let requests = new Map();
+    let captureStartTime = 0;
+    const httpListener = (event) => {
+        if (!event)
+            return;
+        const kind = event.extensionKind ?? event.kind;
+        const data = event.extensionData ?? event;
+        if (kind === "dart:io.httpClient.request.start" || kind === "HttpClientRequest") {
+            const id = data?.id?.toString() ?? data?.isolateId ?? `req_${Date.now()}`;
+            requests.set(id, {
+                id,
+                method: data?.method ?? "GET",
+                uri: data?.uri ?? data?.url ?? "unknown",
+                startTime: Date.now(),
+                requestSize: data?.contentLength ?? data?.requestSize,
+            });
+        }
+        if (kind === "dart:io.httpClient.request.finish" || kind === "HttpClientResponse") {
+            const id = data?.id?.toString() ?? data?.isolateId;
+            const req = id ? requests.get(id) : undefined;
+            if (req) {
+                req.endTime = Date.now();
+                req.statusCode = data?.statusCode ?? data?.status;
+                req.responseSize =
+                    data?.contentLength ?? data?.responseSize ?? data?.compressionState?.length;
+                req.contentType = data?.contentType ?? data?.headers?.["content-type"];
+            }
+        }
+        if (kind === "dart:io.httpClient.request.error") {
+            const id = data?.id?.toString();
+            const req = id ? requests.get(id) : undefined;
+            if (req) {
+                req.endTime = Date.now();
+                req.error = data?.error ?? data?.message ?? "Unknown error";
+            }
+        }
+        if (kind === "Extension" &&
+            data?.extensionKind?.includes("http")) {
+            const extData = data.extensionData;
+            if (extData?.method && extData?.uri) {
+                const id = extData.id?.toString() ?? `ext_${Date.now()}`;
+                const existing = requests.get(id);
+                if (!existing) {
+                    requests.set(id, {
+                        id,
+                        method: extData.method,
+                        uri: extData.uri,
+                        startTime: extData.startTime ?? Date.now(),
+                        endTime: extData.endTime,
+                        statusCode: extData.statusCode ?? extData.status,
+                        responseSize: extData.responseSize ?? extData.contentLength,
+                        contentType: extData.contentType,
+                    });
+                }
+            }
+        }
+    };
+    server.tool("start_network_capture", "Start capturing HTTP network traffic from the running Flutter app. After starting, use the app to trigger API calls, then call stop_network_capture to see all requests with timing, status codes, and sizes.", {}, async () => {
+        if (!client.connected) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Not connected. Use the `connect` tool first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (capturing) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Already capturing network traffic. Call stop_network_capture first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        requests = new Map();
+        captureStartTime = Date.now();
+        capturing = true;
+        client.on("stream:Extension", httpListener);
+        client.on("stream:Logging", httpListener);
+        client.on("event", httpListener);
+        try {
+            await client
+                .callServiceExtension("ext.dart.io.httpEnableTimelineLogging", undefined, {
+                enabled: true,
+            })
+                .catch(() => { });
+        }
+        catch {
+            // Extension may not be available
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "✅ Network capture started. Use the app to trigger API calls, then call `stop_network_capture` to see the results.",
+                },
+            ],
+        };
+    });
+    server.tool("stop_network_capture", "Stop capturing network traffic and get a detailed report of all HTTP requests including method, URL, status code, response time, and payload size.", {
+        sortBy: z
+            .enum(["time", "duration", "size"])
+            .default("time")
+            .describe("Sort requests by: time (chronological), duration (slowest first), size (largest first)"),
+    }, async ({ sortBy }) => {
+        if (!capturing) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Not capturing network traffic. Call start_network_capture first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        capturing = false;
+        client.off("stream:Extension", httpListener);
+        client.off("stream:Logging", httpListener);
+        client.off("event", httpListener);
+        try {
+            await client
+                .callServiceExtension("ext.dart.io.httpEnableTimelineLogging", undefined, {
+                enabled: false,
+            })
+                .catch(() => { });
+        }
+        catch {
+            // Best effort
+        }
+        const durationMs = Date.now() - captureStartTime;
+        const allRequests = Array.from(requests.values());
+        if (allRequests.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `Captured for ${(durationMs / 1000).toFixed(1)}s — no HTTP requests detected.`,
+                            "",
+                            "This can happen if:",
+                            "• The app didn't make any network calls during capture",
+                            "• HTTP timeline logging is not supported in this Flutter version",
+                            "• The app uses a custom HTTP client that doesn't go through dart:io",
+                            "",
+                            "Try making the app load data (pull to refresh, navigate to a new screen).",
+                        ].join("\n"),
+                    },
+                ],
+            };
+        }
+        const sorted = [...allRequests];
+        switch (sortBy) {
+            case "duration":
+                sorted.sort((a, b) => {
+                    const durA = a.endTime ? a.endTime - a.startTime : 0;
+                    const durB = b.endTime ? b.endTime - b.startTime : 0;
+                    return durB - durA;
+                });
+                break;
+            case "size":
+                sorted.sort((a, b) => (b.responseSize ?? 0) - (a.responseSize ?? 0));
+                break;
+            default:
+                sorted.sort((a, b) => a.startTime - b.startTime);
+        }
+        const completedRequests = sorted.filter((r) => r.endTime);
+        const failedRequests = sorted.filter((r) => r.error);
+        const pendingRequests = sorted.filter((r) => !r.endTime && !r.error);
+        const totalSize = sorted.reduce((sum, r) => sum + (r.responseSize ?? 0), 0);
+        const durations = completedRequests.map((r) => r.endTime - r.startTime);
+        const avgDuration = durations.length > 0
+            ? durations.reduce((a, b) => a + b, 0) / durations.length
+            : 0;
+        const maxDuration = durations.length > 0 ? Math.max(...durations) : 0;
+        const output = [
+            "═══════════════════════════════════════════════════════════",
+            "  NETWORK TRAFFIC REPORT",
+            "═══════════════════════════════════════════════════════════",
+            "",
+            "📊 SUMMARY",
+            "───────────────────────────────────────────────────────────",
+            `Captured for ${(durationMs / 1000).toFixed(1)}s`,
+            `Total requests: ${allRequests.length}`,
+            `Completed: ${completedRequests.length} | Failed: ${failedRequests.length} | Pending: ${pendingRequests.length}`,
+            `Total response size: ${formatBytes(totalSize)}`,
+            `Average response time: ${formatDuration(avgDuration)}`,
+            `Slowest request: ${formatDuration(maxDuration)}`,
+            "",
+            "📡 REQUESTS",
+            "───────────────────────────────────────────────────────────",
+        ];
+        for (const req of sorted) {
+            const duration = req.endTime
+                ? formatDuration(req.endTime - req.startTime)
+                : "pending...";
+            const status = req.error
+                ? `❌ ${req.error}`
+                : req.statusCode
+                    ? req.statusCode >= 400
+                        ? `🔴 ${req.statusCode}`
+                        : req.statusCode >= 300
+                            ? `🟡 ${req.statusCode}`
+                            : `🟢 ${req.statusCode}`
+                    : "⏳";
+            const size = req.responseSize
+                ? formatBytes(req.responseSize)
+                : "-";
+            output.push(`${status} ${req.method.padEnd(6)} ${duration.padStart(8)} | ${size.padStart(8)} | ${req.uri}`);
+        }
+        const slowRequests = completedRequests.filter((r) => r.endTime - r.startTime > 2000);
+        const largeResponses = completedRequests.filter((r) => (r.responseSize ?? 0) > 500000);
+        const errors = failedRequests;
+        if (slowRequests.length > 0 ||
+            largeResponses.length > 0 ||
+            errors.length > 0) {
+            output.push("");
+            output.push("⚠️ CONCERNS");
+            output.push("───────────────────────────────────────────────────────────");
+            for (const req of slowRequests.slice(0, 3)) {
+                const dur = formatDuration(req.endTime - req.startTime);
+                output.push(`• SLOW: ${req.method} ${req.uri} took ${dur}`);
+            }
+            for (const req of largeResponses.slice(0, 3)) {
+                output.push(`• LARGE: ${req.method} ${req.uri} returned ${formatBytes(req.responseSize)}`);
+            }
+            for (const req of errors.slice(0, 3)) {
+                output.push(`• ERROR: ${req.method} ${req.uri} — ${req.error}`);
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: output.join("\n"),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=network.js.map

package/dist/tools/network.js.map

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

package/dist/tools/performance-session.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PerformanceSession } from "../services/performance-session.js";
+export declare function registerPerformanceSessionTools(server: McpServer, session: PerformanceSession): void;
+//# sourceMappingURL=performance-session.d.ts.map

package/dist/tools/performance-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-session.d.ts","sourceRoot":"","sources":["../../src/tools/performance-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAwB,MAAM,oCAAoC,CAAC;AAG9F,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,kBAAkB,QAmI5B"}

package/dist/tools/performance-session.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { formatSessionSummary } from "../services/performance-session.js";
+import { PERFORMANCE_SESSIONS_DIR } from "../services/session-types.js";
+export function registerPerformanceSessionTools(server, session) {
+    server.tool("collect_performance_session", `采集指定时长的 Flutter 性能数据并返回结构化 JSON，供 AI 结合源码给出优化方案。
+
+重要：durationSec 仅为「录制窗口」（默认还会 +2s 预热）。工具返回前还需收尾（Timeline/CPU/报告），Android 真机总耗时常为 录制+30s～+120s，期间会输出 [perf] 进度。
+
+推荐话术：用户说「连接 Flutter App，开始采集性能数据 30s」时：
+1. 先 discover_apps / connect（adb 转发口需用真实 VM URI，非 302 端口）
+2. 调用本工具并告知用户「录制 30s，请保持 App 前台；收尾可能再需 1～2 分钟」
+3. 工具返回后读取 filesToInspect，按 hintsForAnalysis 输出 P0/P1/P2
+
+采集项：帧率/jank、Widget 重建（含行号）、CPU Top 函数、网络；内存默认关闭（enableMemory=true 开启）。`, {
+        scenario: z
+            .string()
+            .default("manual-session")
+            .describe("场景标识，如 home-list-scroll"),
+        durationSec: z
+            .number()
+            .min(5)
+            .max(120)
+            .default(30)
+            .describe("录制窗口（秒）；不含收尾分析时间。总耗时见返回 progressLog / wallClockSec"),
+        enableNetwork: z.boolean().default(true),
+        enableCpuProfile: z.boolean().default(true),
+        enableMemory: z
+            .boolean()
+            .default(false)
+            .describe("是否调用 getAllocationProfile(gc:true)；默认 false 以缩短 Android 收尾"),
+        topN: z.number().min(5).max(50).default(15),
+        saveToFile: z
+            .boolean()
+            .default(false)
+            .describe(`是否保存 JSON/AI 报告到 Flutter 工程下的 ${PERFORMANCE_SESSIONS_DIR}/`),
+        outputDir: z
+            .string()
+            .optional()
+            .describe(`覆盖默认输出目录；未指定时使用 {projectRoot}/${PERFORMANCE_SESSIONS_DIR}`),
+        generateAiReport: z
+            .boolean()
+            .default(true)
+            .describe("是否生成 P0/P1/P2 规则引擎分析报告"),
+        projectRoot: z
+            .string()
+            .optional()
+            .describe("Flutter 工程根目录（读取源码 + 默认将报告保存到该目录下的 performance-sessions/）"),
+    }, async ({ scenario, durationSec, enableNetwork, enableCpuProfile, enableMemory, topN, saveToFile, outputDir, generateAiReport, projectRoot, }) => {
+        try {
+            const { result, savedPath } = await session.collect({
+                scenario,
+                durationSec,
+                enableNetwork,
+                enableCpuProfile,
+                enableMemory,
+                topN,
+                saveToFile,
+                outputDir,
+                generateAiReport,
+                projectRoot,
+            });
+            const summary = formatSessionSummary(result);
+            const json = JSON.stringify(result, null, 2);
+            const rec = result.recordingWindowSec ?? durationSec;
+            const wall = result.wallClockSec ?? result.durationSec;
+            const text = [
+                `✅ 性能采集完成（录制 ${rec}s，总耗时 ${wall}s，场景：${scenario}）`,
+                "",
+                "── 采集进度 ──",
+                ...(result.progressLog?.map((p) => `- ${p}`) ?? ["- （无进度日志）"]),
+                "",
+                "── 中文摘要 ──",
+                summary,
+            ];
+            if (result.aiAnalysis) {
+                text.push("", "── AI 优化方案（规则引擎）──", result.aiAnalysis);
+            }
+            text.push("", "── PerformanceSessionResult JSON ──", json);
+            if (savedPath) {
+                text.push("", `已保存: ${savedPath}`);
+                if (result.aiAnalysis) {
+                    text.push(`AI 分析: ${savedPath.replace(/\.json$/, ".ai.md")}`);
+                }
+            }
+            if (result.durationSec < 5) {
+                text.push("", "⚠️ 采集时长过短，数据可能不足。");
+            }
+            return {
+                content: [{ type: "text", text: text.join("\n") }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `采集失败: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=performance-session.js.map

package/dist/tools/performance-session.js.map

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

package/dist/tools/profiling.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FlutterVmServiceClient } from "../services/vm-service-client.js";
+import { Profiler } from "../services/profiler.js";
+export declare function registerProfilingTools(server: McpServer, client: FlutterVmServiceClient, profiler: Profiler): void;
+//# sourceMappingURL=profiling.d.ts.map

package/dist/tools/profiling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiling.d.ts","sourceRoot":"","sources":["../../src/tools/profiling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,QAAQ,QAuKnB"}

package/dist/tools/profiling.js

@@ -0,0 +1,142 @@
+export function registerProfilingTools(server, client, profiler) {
+    server.tool("start_profiling", "Start a performance profiling session. After starting, interact with the app (scroll, tap, navigate) to generate activity, then call stop_profiling to get the analysis. The app should be running in profile mode (`flutter run --profile`) for accurate results.", {}, async () => {
+        if (!client.connected) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Not connected. Use the `connect` tool first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (profiler.isActive) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "A profiling session is already active. Call stop_profiling first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            await profiler.start();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "✅ Profiling started. Interact with the app now (scroll, tap, navigate), then call `stop_profiling` to get the analysis.",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to start profiling: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("stop_profiling", "Stop the current profiling session and get a detailed performance analysis including frame timing, jank detection, CPU hotspots, build/layout/paint phase analysis, and actionable recommendations.", {}, async () => {
+        if (!client.connected) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Not connected. Use the `connect` tool first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!profiler.isActive) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No active profiling session. Call start_profiling first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await profiler.stop();
+            const output = [
+                "═══════════════════════════════════════════════════════════",
+                "  FLUTTER PERFORMANCE ANALYSIS REPORT",
+                "═══════════════════════════════════════════════════════════",
+                "",
+                "📊 SUMMARY",
+                "───────────────────────────────────────────────────────────",
+                ...result.summary,
+                "",
+                "📈 FRAME ANALYSIS",
+                "───────────────────────────────────────────────────────────",
+                `Total frames: ${result.frameAnalysis.totalFrames}`,
+                `Average frame time: ${result.frameAnalysis.averageFrameTimeMs.toFixed(2)}ms`,
+                `P90 frame time: ${result.frameAnalysis.p90FrameTimeMs.toFixed(2)}ms`,
+                `P99 frame time: ${result.frameAnalysis.p99FrameTimeMs.toFixed(2)}ms`,
+                `Max frame time: ${result.frameAnalysis.maxFrameTimeMs.toFixed(2)}ms`,
+                `Jank frames: ${result.frameAnalysis.jankFrames} (${result.frameAnalysis.jankPercentage.toFixed(1)}%)`,
+                `Target: ${result.frameAnalysis.targetFrameTimeMs.toFixed(1)}ms (${Math.round(1000 / result.frameAnalysis.targetFrameTimeMs)}fps)`,
+                "",
+                "🔧 PHASE BREAKDOWN",
+                "───────────────────────────────────────────────────────────",
+                `Build:  avg ${result.buildPhaseAnalysis.avgBuildTimeMs.toFixed(2)}ms | max ${result.buildPhaseAnalysis.maxBuildTimeMs.toFixed(2)}ms | ${result.buildPhaseAnalysis.buildCount} calls`,
+                `Layout: avg ${result.layoutPhaseAnalysis.avgLayoutTimeMs.toFixed(2)}ms | max ${result.layoutPhaseAnalysis.maxLayoutTimeMs.toFixed(2)}ms | ${result.layoutPhaseAnalysis.layoutCount} calls`,
+                `Paint:  avg ${result.paintPhaseAnalysis.avgPaintTimeMs.toFixed(2)}ms | max ${result.paintPhaseAnalysis.maxPaintTimeMs.toFixed(2)}ms | ${result.paintPhaseAnalysis.paintCount} calls`,
+                "",
+            ];
+            if (result.cpuHotspots.length > 0) {
+                output.push("🔥 CPU HOTSPOTS");
+                output.push("───────────────────────────────────────────────────────────");
+                for (const h of result.cpuHotspots.slice(0, 10)) {
+                    const severityIcon = h.severity === "critical"
+                        ? "🔴"
+                        : h.severity === "high"
+                            ? "🟠"
+                            : h.severity === "medium"
+                                ? "🟡"
+                                : "🟢";
+                    output.push(`${severityIcon} ${h.name} [${h.severity.toUpperCase()}]`);
+                    output.push(`   Total: ${h.totalDurationMs.toFixed(1)}ms | Avg: ${h.avgDurationMs.toFixed(1)}ms | Max: ${h.maxDurationMs.toFixed(1)}ms | Calls: ${h.callCount}`);
+                }
+                output.push("");
+            }
+            output.push("💡 RECOMMENDATIONS");
+            output.push("───────────────────────────────────────────────────────────");
+            for (const rec of result.recommendations) {
+                output.push(`• ${rec}`);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: output.join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to stop profiling: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=profiling.js.map

package/dist/tools/profiling.js.map

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

package/dist/tools/rebuild-tracker.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FlutterVmServiceClient } from "../services/vm-service-client.js";
+export declare function registerRebuildTrackerTools(server: McpServer, client: FlutterVmServiceClient): void;
+//# sourceMappingURL=rebuild-tracker.d.ts.map

package/dist/tools/rebuild-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild-tracker.d.ts","sourceRoot":"","sources":["../../src/tools/rebuild-tracker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAU1E,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,sBAAsB,QAkS/B"}