getsentry/MobileBuildMCP

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

何がこれか

MobileBuildMCP は、Model Context Protocol (MCP) サーバーと対応するコマンドラインインターフェース (CLI) を実行する小さなオープンソースパッケージです。目的は、AIコーディングエージェント（例：Claude、Cursor、Codex）が xcodebuild の正確な構文を知らなくても、iOS/macOSプロジェクトのXcode関連ビルドおよびテストコマンドを呼び出せるようにすることです。

だれが使うか

iOS/macOSアプリを自動ワークフローの一部としてビルド・テスト・パッケージ化する必要があるAI駆動の開発アシスタント。
シミュレータビルド、テスト製品の準備、デバイス署名などの一般的なXcodeビルドタスクを、単一のクロスプラットフォームエントリーポイントから使いやすく実行したい人間の開発者。
Xcodeの上位レベルの自動化を構築しているツールチームで、安定した言語に依存しないRPCインターフェース（MCPサーバー）を必要としている人。

コア機能（READMEに記載）

機能	機能の説明
MCPサーバー	MCP互換のAIエージェントからのリクエストを待機し、ビルド、テスト、デバイス署名などのXcode関連ツールをModel Context Protocol経由で公開します。
CLI	終端から直接同じツールを提供します（`mobilebuildmcp <サブコマンド>`）。
2モードインストール	Homebrew（`brew install mobilebuildmcp`）またはグローバルnpmパッケージ（`npm install -g mobilebuildmcp`）で利用可能。
エージェントスキル	AIエージェントにサーバーとCLIの使い方を教えるためのオプションの「MCPスキル」と「CLIスキル」JSONブロブ。
シミュレータワークフロー	特定のシミュレータ向けにビルドするコマンド、テストバンドルを実行せずに生成するオプション、後で選択したシミュレータで実行する機能。
デバイスツール	Xcodeでコード署名が設定されていれば、実デバイス向けにビルドをサポート。
アップグレードヘルパー	`mobilebuildmcp upgrade --check` / `--yes` でインストール済みバイナリをそのまま更新可能。
テレメトリ	ランタイムエラー情報をSentryに送信（オプトアウト可能）。
ドキュメント	インストール、設定、ツールリファレンス、トラブルシューティングをカバーする、補助リポジトリ（`getsentry/xcodebuildmcp.com`）にホストされた豊富なMarkdownドキュメント。

動作方法（概要）

インストール – ユーザーがパッケージをインストール（Homebrewまたはnpm）。インストールにより mobilebuildmcp バイナリとMCPサーバーコードが提供されます。
サーバーの起動 – mobilebuildmcp mcp を実行すると、AIエージェントからのJSON-RPC形式のリクエストを待つHTTPのようなMCPエンドポイントが起動します。
エージェントとのやり取り – AIエージェントは提供された MCPスキル（または CLIスキル）を読み込み、利用可能なJSONメソッド（例：simulator.build、simulator.test）を学びます。エージェントはリクエストを送信し、サーバーは適切な xcodebuild コマンドに変換して実行し、ログをキャプチャして結果を返します。
CLIフォールバック – ユーザーが手動制御を好む場合、mobilebuildmcp simulator build … のようなサブコマンドで同じ操作を直接実行できます。
ステートフルデーモン – CLIは各ワークスペースごとにバックグラウンドデーモンを起動し、ログや状態をキャッシュして繰り返し操作を高速化します。

AI支援開発における重要性

標準化されたインターフェース：MCPを介してXcode機能を公開することで、どのLLMベースのコーディングアシスタントも、各ツールごとにカスタムスクリプトを書かずにiOS/macOSプロジェクトとやり取りできるようになります。
プロンプトの複雑さの低減：スキルファイルによりエージェントに簡潔な「API仕様」を提供し、プロンプトは低レベルのビルドフラグではなくビジネスロジックに集中できます。
クロスプラットフォームエントリーポイント：開発者はローカルで同じコマンドを実行したり、AIエージェントにリモートで実行させたりでき、既存のAI駆動コード生成を活用するCI/CDパイプラインに統合しやすくなります。

すぐに始める（クイックステップ）

# Homebrew（macOSでの推奨）
brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

# または npm
npm install -g mobilebuildmcp@latest

# 確認
mobilebuildmcp --help

# AIクライアント用のMCPサーバーを起動
mobilebuildmcp mcp

# シミュレータ向けビルドの例
mobilebuildmcp simulator build \
  --scheme MyApp \
  --project-path ./MyApp.xcodeproj \
  --simulator-name "iPhone 17"

ライセンスとコミュニティ

MITライセンスで提供。
エラーのテレメトリにSentryを使用（オプトアウト可能）。
GitHubの通常のプルリクエストワークフローで貢献を歓迎。詳細な貢献ガイドラインはドキュメントにリンクされています。

上記のすべての情報はリポジトリのREADMEから直接取得しており、追加の機能は推測されていません。