https://github.com/user-attachments/assets/e92cbd43-cd6c-4ec9-9392-d0d2408a648d] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0] [T0] [T0]] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0]] https://github.com/user-attachments/assets/e92cbd43-cd6c-4ec9-9392-d0d2408a648d] https://github.com/user-attachments/assets/e92cbd43-cd6c-4ec9-9392-d0d2408a648d]]] https://github.com/user-attachments/assets/e92cbd43-cd6c-4ec9-9392-d0d2408a648d]]]]]] [[https://github.com/user-attachments/assets/e92cbd43-cd6c-4ec9-9392-d0d2408a648d]]]]]]] [[[[[[https://github.com/user-attachments/assets/e92cbd43-cd6c-4ec9-9392-d0d2408a648d]]]]]]]]]]]]]] [[[[[[[https://github.com/user-attachments/assets/e92cbd43-cd6c-4ec9-9392-d0d2408a648d]]]]]]]]]]]]]]]]]] [[[[[[[[[[[[[[[[[[[[[[

Xcode Instruments 추적을위한 지능형 성능 분석, 모델 Context 프로토콜을 통해 AI에 의해 구동.

Xcode Instruments 추적을 기록하고 분석하는 Ask Claude는 Time Profiler 회귀를 감지하고 로컬 MCP 서버를 통해 작업 가능한 최적화 권고를 얻습니다.

이 프로젝트는 **Instruments 동반자 **, Instruments.app의 전체 교체가 아닙니다. 그것은 xcrun xctrace: 기록, TOC/XML/HAR 수출, 기호화, 패싱, 보고, 회귀 검사 및 안전한 추적 정리를 통해 부속 사과를 automates. 저장된 .trace]를 악기에 기록합니다. 기본값으로 앱은 흔적에 존재하지 않거나 exportable은 GUI에서 확인할 수 없습니다. 템플릿 또는 도구 보기가 수출되지 않을 때, 서버는 데이터의 사용 대신 제한을 보고합니다.

---

설치

Claude 코드

로컬 xcrun xctrace 설정 확인:

Claude 데스크탑

~/Library/Application Support/Claude/claude_desktop_config.json에 이것을 추가하면 Claude Desktop을 다시 시작합니다.

Codex 클립

Codex가 서버 등록 확인:

옵션 환경 설정

Xcode Instruments Trace Analyzer (MCP)

https://github.com/user-attachments/assets/e92cbd43-cd6c-4ec9-9392-d0d2408a648d

Intelligent performance analysis for Xcode Instruments traces, powered by AI via Model Context Protocol.

Ask Claude to record and analyze Xcode Instruments traces, detect Time Profiler regressions, and get actionable optimization recommendations through a local MCP server.

This project is an Instruments companion, not a full replacement for Instruments.app. It automates the parts Apple exposes through xcrun xctrace: recording, TOC/XML/HAR export, symbolication, parsing, reports, regression checks, and safe trace cleanup. Recording tools open the saved .trace in Instruments.app by default so areas that are not present in the trace or not exportable can be verified in the GUI. When a template or Instruments view is not exportable, the server reports that limitation instead of inventing data.

---

Installation

Claude Code

claude mcp add --transport stdio --scope user xctrace-analyzer -- npx -y @xctrace-analyzer/mcp-server@latest

Verify the local xcrun xctrace setup:

npx -y @xctrace-analyzer/mcp-server@latest --check

Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude Desktop:

{
  "mcpServers": {
    "xctrace-analyzer": {
      "command": "npx",
      "args": ["-y", "@xctrace-analyzer/mcp-server@latest"]
    }
  }
}

Codex CLI

codex mcp add xctrace-analyzer -- npx -y @xctrace-analyzer/mcp-server@latest

Check that Codex registered the server:

codex mcp list

Optional Environment Settings

Claude Desktop-style MCP configs can pass security settings through env:

{
  "mcpServers": {
    "xctrace-analyzer": {
      "command": "npx",
      "args": ["-y", "@xctrace-analyzer/mcp-server@latest"],
      "env": {
        "XCTRACE_ANALYZER_TRACE_ROOT": "/Users/you/Library/Application Support/xctrace-analyzer/traces",
        "XCTRACE_ANALYZER_ALLOW_LAUNCH": "1"
      }
    }
  }
}

Codex can pass the same settings with --env:

codex mcp add xctrace-analyzer \
  --env XCTRACE_ANALYZER_TRACE_ROOT="/Users/you/Library/Application Support/xctrace-analyzer/traces" \
  --env XCTRACE_ANALYZER_ALLOW_LAUNCH=1 \
  -- npx -y @xctrace-analyzer/mcp-server@latest

Build From Source

git clone https://github.com/jamesrochabrun/XcodeTraceMCP.git
cd XcodeTraceMCP
pnpm install --frozen-lockfile
pnpm verify

For local source installs, point your MCP client at packages/mcp-server/dist/index.js.

---

Avoiding Recording Interruptions

Trace recording runs as a single uninterrupted xcrun xctrace session. If your assistant pauses mid-recording to ask for tool approval, the capture window can drift or the run may need to be restarted. To keep recordings clean, before starting a profile: