Xcode MCP

🚀 Xcode MCP (Model Context Protocol) Server

Xcode MCPサーバーは、Xcodeの機能にプログラムからアクセスできる包括的なサーバーです。ClaudeのようなAIアシスタントが、iOS/macOSプロジェクトの作成、ビルド、テスト、管理を直接行えるようにします。

🚀 クイックスタート

Xcode MCPサーバーは、Xcodeの機能にプログラムからアクセスできるようにする包括的なサーバーです。これにより、ClaudeなどのAIアシスタントがiOS/macOSプロジェクトの作成、ビルド、テスト、管理を直接行うことが可能になります。

✨ 主な機能

プロジェクト管理

• 新しいXcodeプロジェクトの作成 - SwiftUIテンプレートを使って完全なプロジェクト構造を生成します。
• プロジェクトのビルド - カスタマイズ可能な設定でアプリをコンパイルします。
• テストの実行 - ユニットテストとUIテストを実行します。
• アプリのアーカイブ - 配布用のアーカイブを作成します。
• スキームの管理 - プロジェクトのスキームを一覧表示し、操作します。

ファイル操作

• Swiftファイルの作成 - ソースコードを直接ファイルシステムに書き込みます。
• Info.plistの変更 - アプリの設定をプログラムで更新します。
• ディレクトリの作成 - プロジェクトのフォルダ構造を設定します。
• ファイルの読み取り - 既存のコードにアクセスし、分析します。

シミュレーター管理

• シミュレーターの一覧表示 - 利用可能なすべてのiOS、watchOS、tvOSシミュレーターを表示します。
• シミュレーターの起動/シャットダウン - シミュレーターのライフサイクルを制御します。
• アプリのインストール - シミュレーターにアプリをデプロイします。
• アプリの起動 - 特定のバンドルIDでアプリを実行します。
• スクリーンショットの取得 - プログラムでシミュレーターのスクリーンショットを撮ります。

📦 インストール

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

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

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

🔧 設定

Claude Desktopの設定ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "xcode-mcp": {
      "command": "node",
      "args": ["/path/to/xcode-mcp/dist/index.js"],
      "env": {}
    }
  }
}

💻 使用例

基本的な使用法

設定が完了すると、Claudeはこれらのツールを直接使用できます。

新しいプロジェクトの作成

ユーザー: "MyAppという名前の新しいiOSアプリを作成して"
Claude: *xcode_create_projectを使ってプロジェクト構造を生成する*

プロジェクトのビルド

ユーザー: "私のiOSアプリをビルドして"
Claude: *適切なパラメータでxcode_build_projectを使用する*

シミュレーターの管理

ユーザー: "利用可能なシミュレーターを表示して"
Claude: *xcode_list_simulatorsを使ってオプションを表示する*

📚 利用可能なツール

🔧 技術詳細

前提条件

• Node.js 16以上
• Xcode 14以上
• macOS 12以上

ソースからビルドする

npm install
npm run build

開発時の実行

npm run dev

🤝 コントリビューション

コントリビューションを歓迎します！詳細はコントリビューションガイドを参照してください。

📋 要件

• macOS：Xcodeとの統合に必要です。
• Xcode：コマンドラインツールをインストールする必要があります。
• Node.js：バージョン16以上が必要です。

🐛 トラブルシューティング

一般的な問題

シミュレーターが表示されない場合

• Xcodeが正しくインストールされていることを確認してください。
• コマンドラインツールをインストールするには、xcode-select --installを実行してください。

ビルドが失敗する場合

• Xcodeプロジェクトのパスが正しいことを確認してください。
• スキーム名が正確に一致することを確認してください。

MCP接続エラーが発生する場合

• 設定を変更した後は、Claude Desktopを再起動してください。
• ログを確認するには、~/Library/Logs/Claude/mcp-server-xcode-mcp.logを参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• AnthropicによるModel Context Protocolをベースに構築されています。
• AppleのXcodeコマンドラインツールを使用しています。

📞 サポート

• 問題報告：GitHub Issues
• ディスカッション：GitHub Discussions
• ウィキ：ドキュメントウィキ