@perfbase/mcp 1.0.0

package/dist/tools/summary.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tool: get_profile_summary
+ * Returns overall statistics about the profile
+ */
+import { z } from 'zod';
+export declare const summarySchema: z.ZodObject<{
+    filePath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+}, {
+    filePath: string;
+}>;
+export type SummaryInput = z.infer<typeof summarySchema>;
+export interface ProfileSummary {
+    spans: string[];
+    totalFunctions: number;
+    totalCalls: number;
+    totalWallTime: string;
+    totalCpuTime: string;
+    totalMemoryAllocated: string;
+    systemStats?: {
+        peakMemory?: string;
+        cpuPercent?: number;
+        loadAvg1m?: number;
+        totalTime?: string;
+    };
+    attributes?: Record<string, string>;
+    topFunctionsByTime: Array<{
+        name: string;
+        time: string;
+        percent: string;
+    }>;
+    topFunctionsByCalls: Array<{
+        name: string;
+        calls: number;
+        percent: string;
+    }>;
+    filesReferenced: number;
+}
+export declare function getProfileSummary(input: SummaryInput): Promise<ProfileSummary>;
+export declare function formatSummaryOutput(result: ProfileSummary): string;
+//# sourceMappingURL=summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/tools/summary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,kBAAkB,EAAE,KAAK,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,mBAAmB,EAAE,KAAK,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,cAAc,CAAC,CA8DzB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAsDlE"}

package/dist/tools/summary.js

@@ -0,0 +1,118 @@
+/**
+ * Tool: get_profile_summary
+ * Returns overall statistics about the profile
+ */
+import { z } from 'zod';
+import { loadProfile } from '../decoder/decompress.js';
+import { walkTrie, getSpanNames } from '../decoder/trie-walker.js';
+import { formatTime, formatBytes, formatNumber } from '../utils/formatting.js';
+export const summarySchema = z.object({
+    filePath: z.string().describe('Path to the PerfBase profile file'),
+});
+export async function getProfileSummary(input) {
+    const data = await loadProfile(input.filePath);
+    const spans = getSpanNames(data);
+    const allFunctions = walkTrie(data);
+    // Calculate totals
+    const totalCalls = allFunctions.reduce((sum, f) => sum + f.callCount, 0);
+    const totalWallTime = allFunctions.reduce((sum, f) => sum + f.totalWallTime, 0);
+    const totalCpuTime = allFunctions.reduce((sum, f) => sum + f.totalCpuTime, 0);
+    const totalMemory = allFunctions.reduce((sum, f) => sum + f.memoryAllocated, 0);
+    // Top 5 by time
+    const byTime = [...allFunctions]
+        .sort((a, b) => b.totalWallTime - a.totalWallTime)
+        .slice(0, 5);
+    // Top 5 by calls
+    const byCalls = [...allFunctions]
+        .sort((a, b) => b.callCount - a.callCount)
+        .slice(0, 5);
+    // System stats
+    const systemStats = data.s
+        ? {
+            peakMemory: data.s.peak_memory
+                ? formatBytes(data.s.peak_memory)
+                : undefined,
+            cpuPercent: data.s.cpu_percent,
+            loadAvg1m: data.s.load_avg_1m,
+            totalTime: data.s.total_time_us
+                ? formatTime(data.s.total_time_us)
+                : undefined,
+        }
+        : undefined;
+    return {
+        spans,
+        totalFunctions: allFunctions.length,
+        totalCalls,
+        totalWallTime: formatTime(totalWallTime),
+        totalCpuTime: formatTime(totalCpuTime),
+        totalMemoryAllocated: formatBytes(totalMemory),
+        systemStats,
+        attributes: data.a,
+        topFunctionsByTime: byTime.map((f) => ({
+            name: f.name,
+            time: formatTime(f.totalWallTime),
+            percent: totalWallTime > 0
+                ? `${((f.totalWallTime / totalWallTime) * 100).toFixed(1)}%`
+                : '0%',
+        })),
+        topFunctionsByCalls: byCalls.map((f) => ({
+            name: f.name,
+            calls: f.callCount,
+            percent: totalCalls > 0
+                ? `${((f.callCount / totalCalls) * 100).toFixed(1)}%`
+                : '0%',
+        })),
+        filesReferenced: data.f.length,
+    };
+}
+export function formatSummaryOutput(result) {
+    const lines = [
+        `# Profile Summary`,
+        ``,
+        `## Overview`,
+        ``,
+        `| Metric | Value |`,
+        `|--------|-------|`,
+        `| Spans | ${result.spans.join(', ') || 'None'} |`,
+        `| Total Functions | ${formatNumber(result.totalFunctions)} |`,
+        `| Total Calls | ${formatNumber(result.totalCalls)} |`,
+        `| Total Wall Time | ${result.totalWallTime} |`,
+        `| Total CPU Time | ${result.totalCpuTime} |`,
+        `| Memory Allocated | ${result.totalMemoryAllocated} |`,
+        `| Files Referenced | ${result.filesReferenced} |`,
+        ``,
+    ];
+    if (result.systemStats) {
+        lines.push(`## System Stats`, ``);
+        if (result.systemStats.peakMemory) {
+            lines.push(`- **Peak Memory**: ${result.systemStats.peakMemory}`);
+        }
+        if (result.systemStats.cpuPercent !== undefined) {
+            lines.push(`- **CPU Usage**: ${result.systemStats.cpuPercent}%`);
+        }
+        if (result.systemStats.loadAvg1m !== undefined) {
+            lines.push(`- **Load Average (1m)**: ${result.systemStats.loadAvg1m}`);
+        }
+        if (result.systemStats.totalTime) {
+            lines.push(`- **Total Execution Time**: ${result.systemStats.totalTime}`);
+        }
+        lines.push(``);
+    }
+    if (result.attributes && Object.keys(result.attributes).length > 0) {
+        lines.push(`## Custom Attributes`, ``);
+        for (const [key, value] of Object.entries(result.attributes)) {
+            lines.push(`- **${key}**: ${value}`);
+        }
+        lines.push(``);
+    }
+    lines.push(`## Top 5 Functions by Time`, ``);
+    for (const f of result.topFunctionsByTime) {
+        lines.push(`- **${f.name}**: ${f.time} (${f.percent})`);
+    }
+    lines.push(``, `## Top 5 Functions by Call Count`, ``);
+    for (const f of result.topFunctionsByCalls) {
+        lines.push(`- **${f.name}**: ${formatNumber(f.calls)} calls (${f.percent})`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=summary.js.map

package/dist/tools/summary.js.map

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

package/dist/utils/formatting.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Formatting utilities for human-readable output
+ */
+/**
+ * Format microseconds to human-readable time
+ */
+export declare function formatTime(microseconds: number): string;
+/**
+ * Format bytes to human-readable size
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format a number with thousand separators
+ */
+export declare function formatNumber(num: number): string;
+/**
+ * Format percentage
+ */
+export declare function formatPercent(value: number, total: number): string;
+/**
+ * Truncate a string with ellipsis
+ */
+export declare function truncate(str: string, maxLength: number): string;
+/**
+ * Format a function location (file:line)
+ */
+export declare function formatLocation(file?: string, line?: number): string;
+/**
+ * Create a simple ASCII table
+ */
+export declare function createTable(headers: string[], rows: string[][], options?: {
+    maxWidth?: number;
+}): string;
+/**
+ * Format function info for display
+ */
+export declare function formatFunctionSummary(info: {
+    name: string;
+    callPath: string;
+    file?: string;
+    line?: number;
+    callCount: number;
+    totalWallTime: number;
+    avgWallTime: number;
+    totalCpuTime: number;
+    memoryAllocated: number;
+}): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,MAAM,CAiCR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAkBT"}

package/dist/utils/formatting.js

@@ -0,0 +1,109 @@
+/**
+ * Formatting utilities for human-readable output
+ */
+/**
+ * Format microseconds to human-readable time
+ */
+export function formatTime(microseconds) {
+    if (microseconds < 1000) {
+        return `${microseconds.toFixed(0)}µs`;
+    }
+    if (microseconds < 1_000_000) {
+        return `${(microseconds / 1000).toFixed(2)}ms`;
+    }
+    return `${(microseconds / 1_000_000).toFixed(2)}s`;
+}
+/**
+ * Format bytes to human-readable size
+ */
+export function formatBytes(bytes) {
+    const absBytes = Math.abs(bytes);
+    const sign = bytes < 0 ? '-' : '';
+    if (absBytes < 1024) {
+        return `${sign}${absBytes}B`;
+    }
+    if (absBytes < 1024 * 1024) {
+        return `${sign}${(absBytes / 1024).toFixed(2)}KB`;
+    }
+    if (absBytes < 1024 * 1024 * 1024) {
+        return `${sign}${(absBytes / (1024 * 1024)).toFixed(2)}MB`;
+    }
+    return `${sign}${(absBytes / (1024 * 1024 * 1024)).toFixed(2)}GB`;
+}
+/**
+ * Format a number with thousand separators
+ */
+export function formatNumber(num) {
+    return num.toLocaleString('en-US');
+}
+/**
+ * Format percentage
+ */
+export function formatPercent(value, total) {
+    if (total === 0)
+        return '0.00%';
+    return `${((value / total) * 100).toFixed(2)}%`;
+}
+/**
+ * Truncate a string with ellipsis
+ */
+export function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength - 3) + '...';
+}
+/**
+ * Format a function location (file:line)
+ */
+export function formatLocation(file, line) {
+    if (!file)
+        return '';
+    if (!line)
+        return file;
+    return `${file}:${line}`;
+}
+/**
+ * Create a simple ASCII table
+ */
+export function createTable(headers, rows, options = {}) {
+    const maxWidth = options.maxWidth ?? 80;
+    // Calculate column widths
+    const colWidths = headers.map((h, i) => {
+        const maxRowWidth = Math.max(...rows.map((r) => (r[i] ?? '').length));
+        return Math.max(h.length, maxRowWidth);
+    });
+    // Truncate columns to fit
+    const totalWidth = colWidths.reduce((a, b) => a + b, 0) + (headers.length - 1) * 3;
+    if (totalWidth > maxWidth) {
+        // Shrink the longest columns proportionally
+        const scale = maxWidth / totalWidth;
+        for (let i = 0; i < colWidths.length; i++) {
+            colWidths[i] = Math.max(5, Math.floor(colWidths[i] * scale));
+        }
+    }
+    // Build header
+    const headerRow = headers
+        .map((h, i) => h.padEnd(colWidths[i]).slice(0, colWidths[i]))
+        .join(' | ');
+    const separator = colWidths.map((w) => '-'.repeat(w)).join('-+-');
+    // Build rows
+    const dataRows = rows.map((row) => row
+        .map((cell, i) => (cell ?? '').padEnd(colWidths[i]).slice(0, colWidths[i]))
+        .join(' | '));
+    return [headerRow, separator, ...dataRows].join('\n');
+}
+/**
+ * Format function info for display
+ */
+export function formatFunctionSummary(info) {
+    const lines = [
+        `**${info.name}**`,
+        `  Path: ${info.callPath}`,
+    ];
+    if (info.file) {
+        lines.push(`  Location: ${formatLocation(info.file, info.line)}`);
+    }
+    lines.push(`  Calls: ${formatNumber(info.callCount)}`, `  Wall Time: ${formatTime(info.totalWallTime)} total, ${formatTime(info.avgWallTime)} avg`, `  CPU Time: ${formatTime(info.totalCpuTime)} total`, `  Memory: ${formatBytes(info.memoryAllocated)} allocated`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=formatting.js.map

package/dist/utils/formatting.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@perfbase/mcp",
+  "version": "1.0.0",
+  "description": "MCP server for PerfBase profiler analysis",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "perfbase-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "profiler",
+    "php",
+    "performance",
+    "perfbase",
+    "claude"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@msgpack/msgpack": "^3.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}