Xcodebuildmcp

🚀 XcodeBuildMCP プロジェクトドキュメント

XcodeBuildMCP は、Xcode とのインタラクションを目的としたツールです。モデルコンテキストプロトコル (MCP) を通じて強化された機能を提供し、開発者が Xcode プロジェクトをより効率的に管理および自動化できるよう支援します。

🚀 クイックスタート

XcodeBuildMCP は、Xcode とのインタラクションを通じて、開発者に強化された機能を提供するツールです。このツールを使用することで、Xcode プロジェクトの管理と自動化をより効率的に行うことができます。

✨ 主な機能

1. Xcode プロジェクト管理

• ビルド機能：Xcode プロジェクトの迅速なビルドをサポートします。
• 診断ツール：詳細な環境チェックと依存関係の状態レポートを提供します。

2. シミュレータ管理

• シミュレータ制御：シミュレータの起動、再起動、停止をサポートします。
• スクリーンショット：現在のシミュレータの画面をキャプチャし、画像のパスを返します。

3. アプリケーションユーティリティ

• アプリインストール：指定されたデバイスまたはシミュレータにアプリケーションを迅速にインストールします。
• ログ記録：リアルタイムのログ出力を取得し、デバッグを支援します。

📦 インストール

インストールガイド

1. npm を通じたインストール：

   npm install -g xcodebuildmcp@1.3.1
   

2. グローバル設定： XcodeBuildMCP の実行環境変数を設定し、正常に動作するようにします。

📚 ドキュメント

なぜ XcodeBuildMCP が必要なのか？

• Swift マクロの問題解決：XcodeBuildMCP はデフォルトで Swift マクロの検証をスキップするオプションを有効にしており、Swift Macros を使用するプロジェクトでのエラーを回避します。
• 自動化ビルドとテスト：Xcode のビルドとテストプロセスを簡素化し、開発効率を向上させます。

トラブルシューティング

診断ツールの使用方法

# npm を使用して診断ツールを実行
npm run xcodebuildmcp-diagnostic@1.3.1

# または直接実行
xcodebuildmcp-diagnostic

ツールの機能

• システムチェック：Node.js とオペレーティングシステムのバージョンを検証します。
• Xcode 設定：Xcode のインストールパスとツールチェーンの状態を確認します。
• 依存関係チェック：idb、xcodebuild などのツールが正しくインストールされていることを確認します。

デモンストレーションケース

1. Cursor を使用したビルドエラーの自動修正

2. スクリーンショットと UI 自動化機能

3. Claude Code での iOS アプリのビルドと実行

動画リンク

貢献ガイド

貢献の方法

1. ローカル設定：
   • リポジトリをクローンします。
   • 依存関係をインストールします：npm install
2. コード提出規範： プロジェクトのコーディングスタイルとドキュメント標準に従います。
3. テスト要件： 提出する前にユニットテストを実行し、機能が正常に動作することを確認します。
4. 問題報告： GitHub リポジトリの Issue を使用して問題を追跡および報告します。

📄 ライセンス

XcodeBuildMCP は MIT ライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。