Xcode

🚀 Xcode-MCP ツールドキュメント

Xcode-MCPは、macOSおよびiOSアプリケーションの開発、テスト、配布プロセスを簡素化するための強力なコマンドラインツールです。様々なXcodeツールと最新のデバイス制御機能を統合することで、開発者の作業効率を向上させます。

🚀 クイックスタート

✨ 主な機能

• xcode-list-schemes: プロジェクト内のすべての利用可能なスキームをリストアップします。
• xcode-test: テストを実行し、結果レポートを生成します。
• xcode-archive: 配布用のIPAパッケージを作成します。
• xcode-clean: ビルドキャッシュと一時ファイルを削除します。
• xcode-run-simulator: 指定されたiOSシミュレータ上でアプリケーションを実行します。
• xcode-run-device: 接続された実機デバイス上でアプリケーションを実行します。

📦 インストール

システム要件

💻 使用例

基本的な使用法

# プロジェクト内のすべてのスキームをリストアップ
xcode-list-schemes --project /Users/username/Projects/MyApp.xcodeproj

# スキームを選択してテストを実行
xcode-test --project /Users/username/Projects/MyApp.xcodeproj --scheme MyApp --configuration Debug

# アプリをパッケージ化して配布
xcode-archive --project /Users/username/Projects/MyApp.xcodeproj --scheme MyApp --configuration Release --output /Users/username/Desktop/MyApp.ipa

高度な使用法

ユーザーがClaudeに与える指示

私のXcodeプロジェクトをチェックし、いくつかのテストを実行してから、配布用にパッケージ化する必要があります。

1. まず、xcode-list-schemesツールを使用して、/Users/username/Projects/MyApp.xcodeprojプロジェクト内のすべてのスキームをリストアップしてください。
2. スキームを確認した後、最初に利用可能なスキームをiPhone 14シミュレータ上でテストしてください。
3. その後、Release構成でアプリをパッケージ化してください。

予想される作業フロー

1. Claudeがxcode-list-schemesツールを実行してすべてのスキームを取得

Project path: /Users/username/Projects/MyApp.xcodeproj

2. 最初に利用可能なスキームを選択してテストを実行

Project path: /Users/username/Projects/MyApp.xcodeproj
Scheme: MyApp
Destination: platform=iOS Simulator,name=iPhone 14

3. アプリをパッケージ化して配布

Project path: /Users/username/Projects/MyApp.xcodeprj
Scheme: MyApp
Configuration: Release
ArchivePath: /Users/username/Desktop/MyApp.ipa

🔧 技術詳細

ローカル開発とテスト

# リポジトリをクローン
git clone https://github.com/yourusername/xcode-mcp.git
cd xcode-mcp

# 依存関係をインストール
npm install

# 開発サーバーを起動
npm run dev

# プロジェクトをビルド
npm run build

# テストを実行
npm test

コードの提出

1. 機能ブランチを作成

git checkout -b feature/new-feature

2. 変更をコミット

git add .
git commit -m "新機能を追加"

3. リモートリポジトリにプッシュ

git push origin feature/new-feature

4. Pull Requestを作成

📄 ライセンス

本ツールはXcode関連のコマンドを実行するため、一定のセキュリティリスクがあります。以下の点に注意してください。

⚠️ 重要提示

• 信頼できるプロジェクトでのみこのツールを使用してください。
• 不明なソースからのプロジェクトには注意してください。
• ビルドパラメータに機密情報を含めないでください。

参考資料

• Xcode ドキュメント
• devicectl ドキュメント
• npm 公式ドキュメント

これらの手順に従うことで、Xcode-MCPツールを効果的に使用して開発プロセスを管理することができます。さらなる支援が必要な場合は、問題追跡ページをご覧になるか、GitHub上で新しい問題を直接提出してください。

Xcode-MCPツールを選んでいただき、ありがとうございます！開発作業に役立つことを願っています。