Instruments

About

Instruments is an MCP server designed to bridge the gap between complex Xcode Instruments `xctrace` output and the needs of AI agents. It eliminates the challenges of parsing verbose XML trace dumps by recording performance data (CPU, SwiftUI, memory, animation hitches), intelligently parsing template-specific metrics, classifying findings by severity with domain-specific thresholds, and summarizing results into concise, actionable JSON. This allows AI agents to easily understand and act upon performance bottlenecks in iOS and macOS applications, making performance analysis more accessible and automated.

Key Features

• Symbolicates traces to add debug symbols, displaying function names instead of raw addresses.
• Parses template-specific performance data with tuned heuristics and classifies findings by severity.
• 0 GitHub stars
• Records performance traces using various Xcode Instruments templates (Time Profiler, SwiftUI, Allocations, Animation Hitches).
• Provides discovery tools to list available profiling templates, connected devices, and instruments.
• Summarizes complex profiling results into concise, actionable JSON for AI consumption.

Use Cases

• Automating comprehensive performance audits for iOS and macOS applications via AI agents.
• Integrating structured performance metrics directly into CI/CD pipelines for automated analysis and regression detection.
• Generating concise, actionable performance reports from raw trace data for developers.