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

モデル コンテキスト プロトコルを介してAIによって動力を与えられたXcodeの器械の跡のための理性的な性能の分析。

ClaudeにXcode Instrumentsのトレースを記録し、分析し、Time Profilerの回帰を検出し、ローカルMCPサーバーを通じて実用的な最適化の推奨事項を入手してください。

このプロジェクトは、Instrumentsコンパニオン**です。 [xcrun xctraceを介して、Appleの露出部分を自動化します。録画、TOC / XML / HARエクスポート、記号化、解析、レポート、回帰チェック、安全なトレースクリーンアップ。 記録ツールは、保存された .trace をインストゥルメントで開きます。 デフォルトでアプリは、トレースやエクスポートできない領域がGUIで検証できるようにします。 テンプレートやインスツルメンツビューがエクスポート不可能な場合、サーバーはデータを発明するのではなく制限を報告します。

お問い合わせ

インストール

##Claudeコード

ローカル [xcrun xctrace の設定を確認します。

##Claudeデスクトップ

これを~/Library/Application Support/Claude/claude_desktop_config.jsonに追加し、Claudeデスクトップを再起動します。

###Codex CLIのコード

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: