@perfonext/build-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Perfonext
+
+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,86 @@
+# perfonext-build-mcp
+
+[![npm](https://img.shields.io/npm/v/@perfonext/build-mcp)](https://www.npmjs.com/package/@perfonext/build-mcp)
+
+`perfonext-build-mcp` is an MCP server for loading and analyzing Next.js build artifacts. It gives GitHub Copilot and other MCP clients structured bundle and route-size data they can reason over instead of forcing the model to inspect raw `.next` manifests.
+
+## What It Does
+
+- loads Next.js build artifacts from a `.next` directory
+- ranks the largest user-facing routes by emitted bundle footprint
+- identifies the heaviest shared chunks that affect multiple routes
+- keeps loaded build snapshots in memory so an MCP client can inspect them without re-reading the same build
+
+## Inputs
+
+The MVP reads build artifacts developers already have after running `next build`:
+
+- `.next/build-manifest.json`
+- `.next/prerender-manifest.json` when present
+- `.next/app-build-manifest.json` when present
+- optional captured `next build` output text to derive build duration
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `load_build_stats` | Parse a Next.js `.next` directory and load the build snapshot into memory |
+| `get_largest_routes` | Rank the heaviest user-facing routes by total emitted chunk bytes |
+| `get_shared_chunks` | Rank shared chunks by size and show which routes depend on them |
+| `compare_builds` | Compare a baseline and current build snapshot to show which routes and chunks grew or shrank |
+
+The output stays machine-readable and includes raw byte counts so Copilot can explain regressions, prioritise fixes, and suggest concrete dependency or import-level follow-up.
+
+## Install
+
+Run directly with `npx`:
+
+```bash
+npx -y @perfonext/build-mcp
+```
+
+Or install globally:
+
+```bash
+npm install -g @perfonext/build-mcp
+```
+
+The executable command remains `perfonext-build-mcp` after installation.
+
+## MCP Configuration
+
+Add this server to VS Code settings:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "perfonext-build": {
+        "command": "npx",
+        "args": ["-y", "@perfonext/build-mcp"]
+      }
+    }
+  }
+}
+```
+
+## Example Copilot Prompts
+
+- "Load the Next.js build in `./.next` and show me the largest routes."
+- "Which shared chunks are affecting the most routes in this build?"
+- "Summarize the build footprint and tell me which routes ship the most JavaScript."
+- "Compare my baseline and current `.next` builds and show me which routes or shared chunks grew the most."
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+Sample fixtures for local validation live under `tests/fixtures/`.
+
+## License
+
+MIT

package/dist/format.d.ts

@@ -0,0 +1,4 @@
+export declare function formatBytes(bytes: number): string;
+export declare function formatMs(value: number | null): string | null;
+export declare function formatPct(value: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAM5D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/format.js

@@ -0,0 +1,19 @@
+export function formatBytes(bytes) {
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    if (bytes < 1024 * 1024) {
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    }
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+export function formatMs(value) {
+    if (value === null) {
+        return null;
+    }
+    return `${value.toFixed(2)}ms`;
+}
+export function formatPct(value) {
+    return `${(value * 100).toFixed(1)}%`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;QACjB,OAAO,GAAG,KAAK,IAAI,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC;IAED,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC"}

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,18 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerLoadBuildStats } from './tools/load-build-stats.js';
+import { registerGetLargestRoutes } from './tools/get-largest-routes.js';
+import { registerGetSharedChunks } from './tools/get-shared-chunks.js';
+import { registerCompareBuilds } from './tools/compare-builds.js';
+const server = new McpServer({
+    name: 'perfonext-build-mcp',
+    version: '0.1.0',
+});
+registerLoadBuildStats(server);
+registerGetLargestRoutes(server);
+registerGetSharedChunks(server);
+registerCompareBuilds(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/parser/analysis.d.ts

@@ -0,0 +1,15 @@
+import type { BuildComparison, ParsedBuildStats, RouteSummaryEntry, SharedChunkSummaryEntry } from './types.js';
+export declare function getBuildSummary(build: ParsedBuildStats): {
+    buildId: string;
+    buildDir: string;
+    routeCount: number;
+    chunkCount: number;
+    sharedChunkCount: number;
+    totalChunkBytes: number;
+    sharedChunkBytes: number;
+    buildTimeMs: number | null;
+};
+export declare function getLargestRoutes(build: ParsedBuildStats, limit: number): RouteSummaryEntry[];
+export declare function getSharedChunks(build: ParsedBuildStats, limit: number): SharedChunkSummaryEntry[];
+export declare function compareBuilds(baseline: ParsedBuildStats, current: ParsedBuildStats, limit: number): BuildComparison;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/parser/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/parser/analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,gBAAgB,EAEhB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAUpB,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAWA;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAc5F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAWjG;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,MAAM,GACZ,eAAe,CAqEjB"}

package/dist/parser/analysis.js

@@ -0,0 +1,110 @@
+function calculateDeltaRatio(baseline, current) {
+    if (baseline === 0) {
+        return current === 0 ? 0 : null;
+    }
+    return (current - baseline) / baseline;
+}
+export function getBuildSummary(build) {
+    return {
+        buildId: build.id,
+        buildDir: build.buildDir,
+        routeCount: build.routes.length,
+        chunkCount: build.chunks.length,
+        sharedChunkCount: build.chunks.filter(chunk => chunk.isShared).length,
+        totalChunkBytes: build.totalChunkBytes,
+        sharedChunkBytes: build.sharedChunkBytes,
+        buildTimeMs: build.buildTimeMs,
+    };
+}
+export function getLargestRoutes(build, limit) {
+    return build.routes.slice(0, limit).map(route => ({
+        path: route.path,
+        type: route.type,
+        prerenderBlockedReason: route.prerenderBlockedReason,
+        totalBytes: route.totalBytes,
+        initialLoadBytes: route.initialLoadBytes,
+        sharedChunkBytes: route.sharedChunkBytes,
+        exclusiveChunkBytes: route.exclusiveChunkBytes,
+        sharedRatio: route.totalBytes === 0 ? 0 : route.sharedChunkBytes / route.totalBytes,
+        chunkCount: route.chunkPaths.length,
+        isPrerendered: route.isPrerendered,
+        isAppRoute: route.isAppRoute,
+    }));
+}
+export function getSharedChunks(build, limit) {
+    return build.chunks
+        .filter(chunk => chunk.isShared)
+        .slice(0, limit)
+        .map(chunk => ({
+        chunkPath: chunk.chunkPath,
+        sizeBytes: chunk.sizeBytes,
+        routeCount: chunk.routeCount,
+        sharedByRoutes: chunk.sharedByRoutes,
+        shareOfAllChunkBytes: build.totalChunkBytes === 0 ? 0 : chunk.sizeBytes / build.totalChunkBytes,
+    }));
+}
+export function compareBuilds(baseline, current, limit) {
+    const baselineRoutes = new Map(baseline.routes.map(route => [route.path, route]));
+    const currentRoutes = new Map(current.routes.map(route => [route.path, route]));
+    const allRoutePaths = Array.from(new Set([...baselineRoutes.keys(), ...currentRoutes.keys()]));
+    const routeDeltas = allRoutePaths
+        .map(path => {
+        const baselineRoute = baselineRoutes.get(path);
+        const currentRoute = currentRoutes.get(path);
+        const baselineBytes = baselineRoute?.totalBytes ?? 0;
+        const currentBytes = currentRoute?.totalBytes ?? 0;
+        return {
+            path,
+            baselineBytes,
+            currentBytes,
+            deltaBytes: currentBytes - baselineBytes,
+            deltaRatio: calculateDeltaRatio(baselineBytes, currentBytes),
+        };
+    })
+        .sort((left, right) => Math.abs(right.deltaBytes) - Math.abs(left.deltaBytes))
+        .slice(0, limit);
+    const baselineChunks = new Map(baseline.chunks.map(chunk => [chunk.chunkPath, chunk]));
+    const currentChunks = new Map(current.chunks.map(chunk => [chunk.chunkPath, chunk]));
+    const allChunkPaths = Array.from(new Set([...baselineChunks.keys(), ...currentChunks.keys()]));
+    const chunkDeltas = allChunkPaths
+        .map(chunkPath => {
+        const baselineChunk = baselineChunks.get(chunkPath);
+        const currentChunk = currentChunks.get(chunkPath);
+        const baselineBytes = baselineChunk?.sizeBytes ?? 0;
+        const currentBytes = currentChunk?.sizeBytes ?? 0;
+        return {
+            chunkPath,
+            baselineBytes,
+            currentBytes,
+            deltaBytes: currentBytes - baselineBytes,
+            deltaRatio: calculateDeltaRatio(baselineBytes, currentBytes),
+            baselineRouteCount: baselineChunk?.routeCount ?? 0,
+            currentRouteCount: currentChunk?.routeCount ?? 0,
+        };
+    })
+        .sort((left, right) => Math.abs(right.deltaBytes) - Math.abs(left.deltaBytes))
+        .slice(0, limit);
+    return {
+        baselineBuildId: baseline.id,
+        currentBuildId: current.id,
+        baselineTotalChunkBytes: baseline.totalChunkBytes,
+        currentTotalChunkBytes: current.totalChunkBytes,
+        totalChunkDeltaBytes: current.totalChunkBytes - baseline.totalChunkBytes,
+        totalChunkDeltaRatio: calculateDeltaRatio(baseline.totalChunkBytes, current.totalChunkBytes),
+        baselineSharedChunkBytes: baseline.sharedChunkBytes,
+        currentSharedChunkBytes: current.sharedChunkBytes,
+        sharedChunkDeltaBytes: current.sharedChunkBytes - baseline.sharedChunkBytes,
+        sharedChunkDeltaRatio: calculateDeltaRatio(baseline.sharedChunkBytes, current.sharedChunkBytes),
+        baselineBuildTimeMs: baseline.buildTimeMs,
+        currentBuildTimeMs: current.buildTimeMs,
+        buildTimeDeltaMs: baseline.buildTimeMs === null || current.buildTimeMs === null
+            ? null
+            : current.buildTimeMs - baseline.buildTimeMs,
+        buildTimeDeltaRatio: baseline.buildTimeMs === null || current.buildTimeMs === null
+            ? null
+            : calculateDeltaRatio(baseline.buildTimeMs, current.buildTimeMs),
+        routeDeltas,
+        chunkDeltas,
+    };
+}
+//# sourceMappingURL=analysis.js.map

package/dist/parser/analysis.js.map

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

package/dist/parser/build-stats.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedBuildStats } from './types.js';
+export declare function parseBuildDurationMs(output: string): number | null;
+export declare function parseBuildStats(buildDirPath: string, buildOutputPath?: string): Promise<ParsedBuildStats>;
+//# sourceMappingURL=build-stats.d.ts.map

package/dist/parser/build-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-stats.d.ts","sourceRoot":"","sources":["../../src/parser/build-stats.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA0B,gBAAgB,EAAqC,MAAM,YAAY,CAAC;AAmH9G,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBlE;AAED,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA+H3B"}

package/dist/parser/build-stats.js

@@ -0,0 +1,201 @@
+import { randomUUID } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+async function readJsonIfPresent(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+async function getFileSizeBytes(filePath) {
+    try {
+        const result = await stat(filePath);
+        return result.size;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return 0;
+        }
+        throw error;
+    }
+}
+function parseRouteMap(raw) {
+    if (!isRecord(raw)) {
+        return {};
+    }
+    const routeMap = {};
+    for (const [route, files] of Object.entries(raw)) {
+        if (!Array.isArray(files)) {
+            continue;
+        }
+        routeMap[route] = files.filter((file) => typeof file === 'string');
+    }
+    return routeMap;
+}
+function shouldIncludeRoute(route) {
+    return !route.startsWith('/_');
+}
+function getRouteType(route, prerenderRoutes, dynamicRoutes) {
+    if (route in dynamicRoutes || route.includes('[')) {
+        return 'dynamic';
+    }
+    const prerenderRoute = prerenderRoutes[route];
+    if (prerenderRoute &&
+        typeof prerenderRoute.initialRevalidateSeconds === 'number' &&
+        Number.isFinite(prerenderRoute.initialRevalidateSeconds) &&
+        prerenderRoute.initialRevalidateSeconds > 0) {
+        return 'isr';
+    }
+    return 'static';
+}
+function getPrerenderBlockedReason(route, prerenderRoutes, dynamicRoutes) {
+    if (route in prerenderRoutes) {
+        const revalidate = prerenderRoutes[route].initialRevalidateSeconds;
+        if (typeof revalidate === 'number' && Number.isFinite(revalidate) && revalidate > 0) {
+            return 'isr';
+        }
+        return null;
+    }
+    // In dynamicRoutes: has getStaticPaths but some or all paths render on-demand
+    if (route in dynamicRoutes) {
+        return 'dynamic-params';
+    }
+    // Not prerendered at all
+    if (route.includes('[')) {
+        return 'dynamic-params';
+    }
+    return 'server-side-props';
+}
+export function parseBuildDurationMs(output) {
+    const match = output.match(/(?:compiled(?:\s+\w+)*\s+in|done\s+in)\s+(\d+(?:\.\d+)?)\s*(ms|s|m)\b/i);
+    if (!match) {
+        return null;
+    }
+    const value = Number(match[1]);
+    const unit = match[2].toLowerCase();
+    if (!Number.isFinite(value)) {
+        return null;
+    }
+    if (unit === 'ms') {
+        return Math.round(value);
+    }
+    if (unit === 's') {
+        return Math.round(value * 1000);
+    }
+    return Math.round(value * 60 * 1000);
+}
+export async function parseBuildStats(buildDirPath, buildOutputPath) {
+    const buildDir = resolve(buildDirPath);
+    const buildManifestPath = join(buildDir, 'build-manifest.json');
+    const prerenderManifestPath = join(buildDir, 'prerender-manifest.json');
+    const appBuildManifestPath = join(buildDir, 'app-build-manifest.json');
+    const buildManifest = await readJsonIfPresent(buildManifestPath);
+    if (!buildManifest) {
+        throw new Error(`Could not find build-manifest.json in ${buildDir}. Run next build first and point this tool at the .next directory.`);
+    }
+    const prerenderManifest = await readJsonIfPresent(prerenderManifestPath);
+    const appBuildManifest = await readJsonIfPresent(appBuildManifestPath);
+    const pagesRouteMap = parseRouteMap(buildManifest.pages);
+    const appRouteMap = parseRouteMap(appBuildManifest?.pages);
+    const prerenderRoutes = isRecord(prerenderManifest?.routes)
+        ? prerenderManifest.routes
+        : {};
+    const dynamicRoutes = isRecord(prerenderManifest?.dynamicRoutes)
+        ? prerenderManifest.dynamicRoutes
+        : {};
+    const allRoutes = new Map();
+    for (const [route, chunkPaths] of Object.entries(pagesRouteMap)) {
+        if (!shouldIncludeRoute(route)) {
+            continue;
+        }
+        allRoutes.set(route, {
+            chunkPaths: Array.from(new Set(chunkPaths)),
+            isAppRoute: false,
+        });
+    }
+    for (const [route, chunkPaths] of Object.entries(appRouteMap)) {
+        if (!shouldIncludeRoute(route)) {
+            continue;
+        }
+        const existing = allRoutes.get(route);
+        allRoutes.set(route, {
+            chunkPaths: Array.from(new Set([...(existing?.chunkPaths ?? []), ...chunkPaths])),
+            isAppRoute: true,
+        });
+    }
+    const chunkRouteMap = new Map();
+    for (const [route, details] of allRoutes) {
+        for (const chunkPath of details.chunkPaths) {
+            if (!chunkRouteMap.has(chunkPath)) {
+                chunkRouteMap.set(chunkPath, new Set());
+            }
+            chunkRouteMap.get(chunkPath).add(route);
+        }
+    }
+    const chunkSizeEntries = await Promise.all(Array.from(chunkRouteMap.keys()).map(async (chunkPath) => {
+        const normalized = chunkPath.replace(/^\//, '');
+        const sizeBytes = await getFileSizeBytes(join(buildDir, normalized));
+        return [chunkPath, sizeBytes];
+    }));
+    const chunkSizeMap = new Map(chunkSizeEntries);
+    const chunks = Array.from(chunkRouteMap.entries())
+        .map(([chunkPath, routeSet]) => ({
+        chunkPath,
+        sizeBytes: chunkSizeMap.get(chunkPath) ?? 0,
+        routeCount: routeSet.size,
+        sharedByRoutes: Array.from(routeSet).sort(),
+        isShared: routeSet.size > 1,
+    }))
+        .sort((left, right) => right.sizeBytes - left.sizeBytes);
+    const routes = Array.from(allRoutes.entries())
+        .map(([route, details]) => {
+        const totalBytes = details.chunkPaths.reduce((sum, chunkPath) => sum + (chunkSizeMap.get(chunkPath) ?? 0), 0);
+        const sharedChunkBytes = details.chunkPaths.reduce((sum, chunkPath) => {
+            const routeCount = chunkRouteMap.get(chunkPath)?.size ?? 0;
+            if (routeCount > 1) {
+                return sum + (chunkSizeMap.get(chunkPath) ?? 0);
+            }
+            return sum;
+        }, 0);
+        return {
+            path: route,
+            type: getRouteType(route, prerenderRoutes, dynamicRoutes),
+            prerenderBlockedReason: getPrerenderBlockedReason(route, prerenderRoutes, dynamicRoutes),
+            chunkPaths: details.chunkPaths,
+            totalBytes,
+            initialLoadBytes: totalBytes,
+            sharedChunkBytes,
+            exclusiveChunkBytes: totalBytes - sharedChunkBytes,
+            isPrerendered: route in prerenderRoutes,
+            isAppRoute: details.isAppRoute,
+        };
+    })
+        .sort((left, right) => right.totalBytes - left.totalBytes);
+    let buildTimeMs = null;
+    let resolvedBuildOutputPath = null;
+    if (buildOutputPath) {
+        resolvedBuildOutputPath = resolve(buildOutputPath);
+        const output = await readFile(resolvedBuildOutputPath, 'utf-8');
+        buildTimeMs = parseBuildDurationMs(output);
+    }
+    return {
+        id: randomUUID(),
+        buildDir,
+        buildOutputPath: resolvedBuildOutputPath,
+        routes,
+        chunks,
+        totalChunkBytes: chunks.reduce((sum, chunk) => sum + chunk.sizeBytes, 0),
+        sharedChunkBytes: chunks.reduce((sum, chunk) => sum + (chunk.isShared ? chunk.sizeBytes : 0), 0),
+        buildTimeMs,
+    };
+}
+//# sourceMappingURL=build-stats.js.map

package/dist/parser/build-stats.js.map

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

package/dist/parser/types.d.ts

@@ -0,0 +1,86 @@
+export type RouteType = 'static' | 'dynamic' | 'isr';
+export type PrerenderBlockedReason = 'isr' | 'dynamic-params' | 'server-side-props' | null;
+export interface BuildRoute {
+    path: string;
+    type: RouteType;
+    prerenderBlockedReason: PrerenderBlockedReason;
+    chunkPaths: string[];
+    totalBytes: number;
+    initialLoadBytes: number;
+    sharedChunkBytes: number;
+    exclusiveChunkBytes: number;
+    isPrerendered: boolean;
+    isAppRoute: boolean;
+}
+export interface BuildChunk {
+    chunkPath: string;
+    sizeBytes: number;
+    routeCount: number;
+    sharedByRoutes: string[];
+    isShared: boolean;
+}
+export interface ParsedBuildStats {
+    id: string;
+    buildDir: string;
+    buildOutputPath: string | null;
+    routes: BuildRoute[];
+    chunks: BuildChunk[];
+    totalChunkBytes: number;
+    sharedChunkBytes: number;
+    buildTimeMs: number | null;
+}
+export interface RouteSummaryEntry {
+    path: string;
+    type: RouteType;
+    prerenderBlockedReason: PrerenderBlockedReason;
+    totalBytes: number;
+    initialLoadBytes: number;
+    sharedChunkBytes: number;
+    exclusiveChunkBytes: number;
+    sharedRatio: number;
+    chunkCount: number;
+    isPrerendered: boolean;
+    isAppRoute: boolean;
+}
+export interface SharedChunkSummaryEntry {
+    chunkPath: string;
+    sizeBytes: number;
+    routeCount: number;
+    sharedByRoutes: string[];
+    shareOfAllChunkBytes: number;
+}
+export interface RouteDeltaEntry {
+    path: string;
+    baselineBytes: number;
+    currentBytes: number;
+    deltaBytes: number;
+    deltaRatio: number | null;
+}
+export interface ChunkDeltaEntry {
+    chunkPath: string;
+    baselineBytes: number;
+    currentBytes: number;
+    deltaBytes: number;
+    deltaRatio: number | null;
+    baselineRouteCount: number;
+    currentRouteCount: number;
+}
+export interface BuildComparison {
+    baselineBuildId: string;
+    currentBuildId: string;
+    baselineTotalChunkBytes: number;
+    currentTotalChunkBytes: number;
+    totalChunkDeltaBytes: number;
+    totalChunkDeltaRatio: number | null;
+    baselineSharedChunkBytes: number;
+    currentSharedChunkBytes: number;
+    sharedChunkDeltaBytes: number;
+    sharedChunkDeltaRatio: number | null;
+    baselineBuildTimeMs: number | null;
+    currentBuildTimeMs: number | null;
+    buildTimeDeltaMs: number | null;
+    buildTimeDeltaRatio: number | null;
+    routeDeltas: RouteDeltaEntry[];
+    chunkDeltas: ChunkDeltaEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/parser/types.d.ts.map

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

package/dist/parser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/parser/types.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,12 @@
+import type { ParsedBuildStats } from './parser/types.js';
+export declare function storeBuildStats(build: ParsedBuildStats): void;
+export declare function getBuildStats(id: string): ParsedBuildStats | undefined;
+export declare function listBuildStats(): Array<{
+    id: string;
+    buildDir: string;
+    routeCount: number;
+    chunkCount: number;
+    totalChunkBytes: number;
+    buildTimeMs: number | null;
+}>;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEtE;AAED,wBAAgB,cAAc,IAAI,KAAK,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC,CASD"}

package/dist/store.js

@@ -0,0 +1,18 @@
+const builds = new Map();
+export function storeBuildStats(build) {
+    builds.set(build.id, build);
+}
+export function getBuildStats(id) {
+    return builds.get(id);
+}
+export function listBuildStats() {
+    return Array.from(builds.values()).map(build => ({
+        id: build.id,
+        buildDir: build.buildDir,
+        routeCount: build.routes.length,
+        chunkCount: build.chunks.length,
+        totalChunkBytes: build.totalChunkBytes,
+        buildTimeMs: build.buildTimeMs,
+    }));
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEnD,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,cAAc;IAQ5B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/C,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC/B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC/B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/tools/compare-builds.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCompareBuilds(server: McpServer): void;
+//# sourceMappingURL=compare-builds.d.ts.map

package/dist/tools/compare-builds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-builds.d.ts","sourceRoot":"","sources":["../../src/tools/compare-builds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkF7D"}

package/dist/tools/compare-builds.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { formatBytes, formatMs, formatPct } from '../format.js';
+import { compareBuilds as compareLoadedBuilds } from '../parser/analysis.js';
+import { getBuildStats, listBuildStats } from '../store.js';
+function formatNullableRatio(value) {
+    return value === null ? null : formatPct(value);
+}
+export function registerCompareBuilds(server) {
+    server.registerTool('compare_builds', {
+        title: 'Compare Builds',
+        description: 'Compare two loaded Next.js builds and show which routes and chunks grew or shrank the most.',
+        inputSchema: {
+            baselineBuildId: z.string().optional().describe('Baseline build ID from load_build_stats. Omit to list loaded builds.'),
+            currentBuildId: z.string().optional().describe('Current build ID from load_build_stats. Omit to list loaded builds.'),
+            limit: z.number().int().positive().max(25).optional().describe('How many route and chunk deltas to include. Defaults to 10.'),
+        },
+    }, async ({ baselineBuildId, currentBuildId, limit }) => {
+        if (!baselineBuildId || !currentBuildId) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            builds: listBuildStats().map(build => ({
+                                id: build.id,
+                                buildDir: build.buildDir,
+                                routeCount: build.routeCount,
+                                chunkCount: build.chunkCount,
+                                totalChunkBytes: build.totalChunkBytes,
+                                totalChunkBytesText: formatBytes(build.totalChunkBytes),
+                                buildTimeText: formatMs(build.buildTimeMs),
+                            })),
+                        }, null, 2),
+                    }],
+            };
+        }
+        const baseline = getBuildStats(baselineBuildId);
+        if (!baseline) {
+            throw new Error(`Build "${baselineBuildId}" not found. Call compare_builds without IDs to list loaded builds.`);
+        }
+        const current = getBuildStats(currentBuildId);
+        if (!current) {
+            throw new Error(`Build "${currentBuildId}" not found. Call compare_builds without IDs to list loaded builds.`);
+        }
+        const comparison = compareLoadedBuilds(baseline, current, limit ?? 10);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        ...comparison,
+                        baselineTotalChunkBytesText: formatBytes(comparison.baselineTotalChunkBytes),
+                        currentTotalChunkBytesText: formatBytes(comparison.currentTotalChunkBytes),
+                        totalChunkDeltaBytesText: formatBytes(Math.abs(comparison.totalChunkDeltaBytes)),
+                        totalChunkDeltaDirection: comparison.totalChunkDeltaBytes >= 0 ? 'growth' : 'shrink',
+                        totalChunkDeltaRatioText: formatNullableRatio(comparison.totalChunkDeltaRatio),
+                        baselineSharedChunkBytesText: formatBytes(comparison.baselineSharedChunkBytes),
+                        currentSharedChunkBytesText: formatBytes(comparison.currentSharedChunkBytes),
+                        sharedChunkDeltaBytesText: formatBytes(Math.abs(comparison.sharedChunkDeltaBytes)),
+                        sharedChunkDeltaDirection: comparison.sharedChunkDeltaBytes >= 0 ? 'growth' : 'shrink',
+                        sharedChunkDeltaRatioText: formatNullableRatio(comparison.sharedChunkDeltaRatio),
+                        baselineBuildTimeText: formatMs(comparison.baselineBuildTimeMs),
+                        currentBuildTimeText: formatMs(comparison.currentBuildTimeMs),
+                        buildTimeDeltaText: comparison.buildTimeDeltaMs === null ? null : formatMs(Math.abs(comparison.buildTimeDeltaMs)),
+                        buildTimeDeltaDirection: comparison.buildTimeDeltaMs === null ? null : comparison.buildTimeDeltaMs >= 0 ? 'slower' : 'faster',
+                        buildTimeDeltaRatioText: formatNullableRatio(comparison.buildTimeDeltaRatio),
+                        routeDeltas: comparison.routeDeltas.map(route => ({
+                            ...route,
+                            baselineBytesText: formatBytes(route.baselineBytes),
+                            currentBytesText: formatBytes(route.currentBytes),
+                            deltaBytesText: formatBytes(Math.abs(route.deltaBytes)),
+                            deltaDirection: route.deltaBytes >= 0 ? 'growth' : 'shrink',
+                            deltaRatioText: formatNullableRatio(route.deltaRatio),
+                        })),
+                        chunkDeltas: comparison.chunkDeltas.map(chunk => ({
+                            ...chunk,
+                            baselineBytesText: formatBytes(chunk.baselineBytes),
+                            currentBytesText: formatBytes(chunk.currentBytes),
+                            deltaBytesText: formatBytes(Math.abs(chunk.deltaBytes)),
+                            deltaDirection: chunk.deltaBytes >= 0 ? 'growth' : 'shrink',
+                            deltaRatioText: formatNullableRatio(chunk.deltaRatio),
+                        })),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=compare-builds.js.map

package/dist/tools/compare-builds.js.map

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

package/dist/tools/get-largest-routes.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetLargestRoutes(server: McpServer): void;
+//# sourceMappingURL=get-largest-routes.d.ts.map

package/dist/tools/get-largest-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-largest-routes.d.ts","sourceRoot":"","sources":["../../src/tools/get-largest-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+ChE"}

package/dist/tools/get-largest-routes.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { formatBytes, formatMs, formatPct } from '../format.js';
+import { getLargestRoutes } from '../parser/analysis.js';
+import { getBuildStats, listBuildStats } from '../store.js';
+export function registerGetLargestRoutes(server) {
+    server.registerTool('get_largest_routes', {
+        title: 'Get Largest Routes',
+        description: 'Rank the heaviest user-facing routes in a loaded Next.js build by emitted chunk bytes.',
+        inputSchema: {
+            buildId: z.string().optional().describe('Build ID returned from load_build_stats. Omit to list loaded builds.'),
+            limit: z.number().int().positive().max(25).optional().describe('How many routes to include. Defaults to 10.'),
+        },
+    }, async ({ buildId, limit }) => {
+        if (!buildId) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            builds: listBuildStats().map(build => ({
+                                ...build,
+                                totalChunkBytesText: formatBytes(build.totalChunkBytes),
+                                buildTimeText: formatMs(build.buildTimeMs),
+                            })),
+                        }, null, 2),
+                    }],
+            };
+        }
+        const build = getBuildStats(buildId);
+        if (!build) {
+            throw new Error(`Build "${buildId}" not found. Call get_largest_routes without a buildId to list all loaded builds.`);
+        }
+        const routes = getLargestRoutes(build, limit ?? 10);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        buildId: build.id,
+                        routes: routes.map(route => ({
+                            ...route,
+                            totalBytesText: formatBytes(route.totalBytes),
+                            initialLoadBytesText: formatBytes(route.initialLoadBytes),
+                            sharedChunkBytesText: formatBytes(route.sharedChunkBytes),
+                            exclusiveChunkBytesText: formatBytes(route.exclusiveChunkBytes),
+                            sharedRatioText: formatPct(route.sharedRatio),
+                        })),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=get-largest-routes.js.map

package/dist/tools/get-largest-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-largest-routes.js","sourceRoot":"","sources":["../../src/tools/get-largest-routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE;QACxC,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,wFAAwF;QACrG,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;YAC/G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAC9G;KACF,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gCACrC,GAAG,KAAK;gCACR,mBAAmB,EAAE,WAAW,CAAC,KAAK,CAAC,eAAe,CAAC;gCACvD,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;6BAC3C,CAAC,CAAC;yBACJ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,mFAAmF,CAAC,CAAC;QACxH,CAAC;QAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK,CAAC,EAAE;wBACjB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;4BAC3B,GAAG,KAAK;4BACR,cAAc,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;4BAC7C,oBAAoB,EAAE,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC;4BACzD,oBAAoB,EAAE,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC;4BACzD,uBAAuB,EAAE,WAAW,CAAC,KAAK,CAAC,mBAAmB,CAAC;4BAC/D,eAAe,EAAE,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC;yBAC9C,CAAC,CAAC;qBACJ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/get-shared-chunks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetSharedChunks(server: McpServer): void;
+//# sourceMappingURL=get-shared-chunks.d.ts.map

package/dist/tools/get-shared-chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-shared-chunks.d.ts","sourceRoot":"","sources":["../../src/tools/get-shared-chunks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4C/D"}

package/dist/tools/get-shared-chunks.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { formatBytes, formatMs, formatPct } from '../format.js';
+import { getSharedChunks } from '../parser/analysis.js';
+import { getBuildStats, listBuildStats } from '../store.js';
+export function registerGetSharedChunks(server) {
+    server.registerTool('get_shared_chunks', {
+        title: 'Get Shared Chunks',
+        description: 'Rank the heaviest shared chunks in a loaded Next.js build and show which routes depend on them.',
+        inputSchema: {
+            buildId: z.string().optional().describe('Build ID returned from load_build_stats. Omit to list loaded builds.'),
+            limit: z.number().int().positive().max(25).optional().describe('How many shared chunks to include. Defaults to 10.'),
+        },
+    }, async ({ buildId, limit }) => {
+        if (!buildId) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            builds: listBuildStats().map(build => ({
+                                ...build,
+                                totalChunkBytesText: formatBytes(build.totalChunkBytes),
+                                buildTimeText: formatMs(build.buildTimeMs),
+                            })),
+                        }, null, 2),
+                    }],
+            };
+        }
+        const build = getBuildStats(buildId);
+        if (!build) {
+            throw new Error(`Build "${buildId}" not found. Call get_shared_chunks without a buildId to list all loaded builds.`);
+        }
+        const chunks = getSharedChunks(build, limit ?? 10);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        buildId: build.id,
+                        chunks: chunks.map(chunk => ({
+                            ...chunk,
+                            sizeBytesText: formatBytes(chunk.sizeBytes),
+                            shareOfAllChunkBytesText: formatPct(chunk.shareOfAllChunkBytes),
+                        })),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=get-shared-chunks.js.map

package/dist/tools/get-shared-chunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-shared-chunks.js","sourceRoot":"","sources":["../../src/tools/get-shared-chunks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CAAC,mBAAmB,EAAE;QACvC,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,iGAAiG;QAC9G,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;YAC/G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;SACrH;KACF,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gCACrC,GAAG,KAAK;gCACR,mBAAmB,EAAE,WAAW,CAAC,KAAK,CAAC,eAAe,CAAC;gCACvD,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;6BAC3C,CAAC,CAAC;yBACJ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,kFAAkF,CAAC,CAAC;QACvH,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK,CAAC,EAAE;wBACjB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;4BAC3B,GAAG,KAAK;4BACR,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC;4BAC3C,wBAAwB,EAAE,SAAS,CAAC,KAAK,CAAC,oBAAoB,CAAC;yBAChE,CAAC,CAAC;qBACJ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/load-build-stats.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerLoadBuildStats(server: McpServer): void;
+//# sourceMappingURL=load-build-stats.d.ts.map

package/dist/tools/load-build-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-build-stats.d.ts","sourceRoot":"","sources":["../../src/tools/load-build-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyB9D"}

package/dist/tools/load-build-stats.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { formatBytes, formatMs } from '../format.js';
+import { getBuildSummary } from '../parser/analysis.js';
+import { parseBuildStats } from '../parser/build-stats.js';
+import { storeBuildStats } from '../store.js';
+export function registerLoadBuildStats(server) {
+    server.registerTool('load_build_stats', {
+        title: 'Load Build Stats',
+        description: 'Parse a Next.js .next directory and load route and chunk footprint data for later analysis.',
+        inputSchema: {
+            buildDir: z.string().describe('Absolute or relative path to the Next.js .next build directory'),
+            buildOutputPath: z.string().optional().describe('Optional path to captured next build terminal output for deriving build duration'),
+        },
+    }, async ({ buildDir, buildOutputPath }) => {
+        const build = await parseBuildStats(buildDir, buildOutputPath);
+        storeBuildStats(build);
+        const summary = getBuildSummary(build);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        ...summary,
+                        totalChunkBytesText: formatBytes(summary.totalChunkBytes),
+                        sharedChunkBytesText: formatBytes(summary.sharedChunkBytes),
+                        buildTimeText: formatMs(summary.buildTimeMs),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=load-build-stats.js.map

package/dist/tools/load-build-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-build-stats.js","sourceRoot":"","sources":["../../src/tools/load-build-stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE;QACtC,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,6FAA6F;QAC1G,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;YAC/F,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kFAAkF,CAAC;SACpI;KACF,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,EAAE;QACzC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QAC/D,eAAe,CAAC,KAAK,CAAC,CAAC;QAEvB,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,GAAG,OAAO;wBACV,mBAAmB,EAAE,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC;wBACzD,oBAAoB,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC;wBAC3D,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC;qBAC7C,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@perfonext/build-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for analyzing Next.js build artifacts, route bundle footprint, and shared chunks",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "perfonext-build-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "inspector": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "github-copilot",
+    "nextjs",
+    "build",
+    "bundle",
+    "performance",
+    "route-size",
+    "chunk-analysis"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/souvikxcoder/perfonext-build-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/souvikxcoder/perfonext-build-mcp/issues"
+  },
+  "homepage": "https://github.com/souvikxcoder/perfonext-build-mcp#readme",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3",
+    "vitest": "^3.2.4"
+  }
+}