Xcode 診断 MCP プラグイン

Xcode ビルドログからエラーと警告を抽出して表示するための MCP (Model Control Protocol) プラグイン。

概要

このプラグインは、Model Control Protocol（MCP）仕様を実装し、互換性のあるAIアシスタントにXcodeの診断機能を提供します。Xcodeのビルドシステムに接続し、Swiftプロジェクトから診断情報（エラーと警告）を抽出、解析、表示します。これにより、AIアシスタントはビルドログを手動で検索することなく、コード内の問題を迅速に特定できるようになります。

これはログレベルで機能するため、このツールを実行する前に Xcode がすでにビルドを試行している必要があることに注意してください。

前提条件

macOSオペレーティングシステム
Xcodeがインストールされている
Python 3.6以上

インストール

PyPIからのインストール

Xcode Diagnostics MCP プラグインをインストールする最も簡単な方法:

pip install mcp-xcode-diagnostics

GitHubからのインストール

GitHub から直接インストールできます:

pip install git+https://github.com/leftspin/mcp-xcode-diagnostics.git

ソースからインストールする

ソースからインストールするには:

このリポジトリをクローンまたはダウンロードする
pip を使用してプラグインをインストールします。
cd mcp-xcode-diagnostics pip install .

このプラグインは、MCP 互換のあらゆるクライアントで使用できるようになりました。

特徴

DerivedData にビルドログがあるすべての Xcode プロジェクトを一覧表示します
特定のプロジェクトの最新のビルドログからエラーと警告を抽出します
関連するメモや修正提案を含む複雑な診断を解析します
ファイルパス、行番号、エラーメッセージなど、各問題に関する詳細情報を提供します。
Swiftの並行性に関する警告をキャプチャするために最適化されています

サポートされている診断タイプ

プラグインは、次のようなさまざまな種類の Xcode 診断を検出して表示できます。

エラー

構文エラー（例：「{' が必要です」または「式が必要です」）
型エラー（例：「型Xの値を期待される引数型Yに変換できない」）
未解決の識別子と欠落したインポート
プロトコル適合エラー
一般的なパラメータ推論の失敗
アクセス制御違反

警告

未使用の変数、定数、および結果
精度が失われる可能性のある暗黙の変換
冗長なコードや不要な表現
非推奨の警告
文字列補間の問題
Swift の同時実行に関する警告には以下が含まれます:
- 非分離グローバル共有可変状態警告
- 主役の孤立に関する警告
- プロトコル適合同時実行警告
- アクター分離違反
- Swift 6 言語モードの互換性に関する警告

メモと修正案

エラーや警告に関する追加のコンテキストを提供する関連メモ
問題を解決するためのコード変更を提案する修正提案
問題のあるコードを示すコードスニペット

制限事項

ランタイムログのバイナリ/シリアル化形式は完全に解析されない可能性があります
高度に専門化された診断フォーマットは認識されない場合があります
非常に大きなビルドログは切り捨てられる可能性がある
プロジェクト固有のカスタム診断が適切に分類されない可能性があります

MCPツール

プラグインは、2 つの主要な MCP ツールを提供します。

get_xcode_projects

DerivedData ディレクトリ内のビルドログを含むすべての Xcode プロジェクトを一覧表示します。

パラメータ: なし

get_project_diagnostics

特定のプロジェクトの最新のビルドログから診断情報を取得します。

パラメータ:

project_dir_name : DerivedData内のプロジェクトのディレクトリ名（例： 'ProjectName-hash'）
include_warnings : エラーに加えて警告を含めるかどうか（デフォルト: True）

デバッグ情報

デバッグの目的で、プラグインは生のログ出力を次の場所に保存します。

/tmp/xcode-mcp-debug.log - メインアプリケーションログ
/tmp/xcode-diagnostic-raw.log - Xcode アクティビティログからの生の出力

出力例

{
  "success": true,
  "log_file": "/path/to/build.xcactivitylog",
  "timestamp": "2025-03-11T12:34:56.789",
  "errors": [
    {
      "type": "error",
      "message": "use of unresolved identifier 'NonExistentType'",
      "file_path": "/path/to/MyFile.swift",
      "line_number": 42,
      "column": 15,
      "code": "    let x: NonExistentType = value",
      "notes": []
    }
  ],
  "warnings": [
    {
      "type": "warning",
      "message": "static property 'sharedInstance' is not concurrency-safe because it is nonisolated global shared mutable state; this is an error in the Swift 6 language mode",
      "file_path": "/path/to/SharedManager.swift",
      "line_number": 10,
      "column": 16,
      "code": "    static var sharedInstance: SharedManager?",
      "notes": [
        {
          "type": "note",
          "message": "convert 'sharedInstance' to a 'let' constant to make 'Sendable' shared state immutable",
          "file_path": "/path/to/SharedManager.swift",
          "line_number": 10,
          "column": 16
        }
      ]
    }
  ],
  "error_count": 1,
  "warning_count": 1
}

テスト

プラグインには解析機能を検証するためのテストスイートが含まれています。

# Run all tests
python -m unittest test_xcode_diagnostics.py

ライセンス

このプロジェクトは MIT ライセンスの下で利用可能です。

Xcode Diagnostics MCP Plugin

Integrations