MCP server for Apple platform profiling via xctrace/Instruments
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"apple-instruments-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# apple-instruments-mcp `apple-instruments-mcp` is a Python MCP server for profiling Apple platform apps and processes with Instruments through `xcrun xctrace`. It lets MCP clients such as Claude Desktop record traces, inspect existing `.trace` bundles, and return concise performance reports with actionable recommendations. The server can target iOS, iPadOS, macOS, tvOS, watchOS, visionOS, simulators, physical devices, and host processes when those targets are visible to the installed Xcode/Instruments toolchain. Actual template and device support is determined by `xcrun xctrace list devices` and `xcrun xctrace list templates` on your Mac. ## Features - Record new traces with `xctrace` from an MCP client. - Analyze existing `.trace` bundles without recording again. - Report launch time, memory allocations, leaks, CPU hot spots, and network activity. - Launch apps by bundle ID or executable path. - Attach to running processes by process name or PID. - Record all processes when an Instruments template supports it. - List available devices, simulators, runtimes, and Instruments templates. - Return raw or JSON-structured device/template listings. - Preview the generated `xctrace` command with `dry_run`. - Keep `.trace` and XML artifacts for later inspection. - Return human-readable summaries with top offenders and suggested fixes. - Runs as a standard stdio MCP server. ## Requirements - macOS - Xcode with Instruments installed - Xcode Command Line Tools: `xcode-select --install` - Python 3.11 or newer - A supported target visible to `xctrace`: booted simulator, connected device, local macOS app, running process, or all-processes recording. Physical devices may require enabling UI automation in `Settings > Developer`. ## Installation The package is published on PyPI. The recommended way is to run it through [`uvx`](https://github.com/astral-sh/uv), which downloads and caches the server on demand without polluting your environment: ```bash uvx apple-instruments…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.