Xcode MCPサーバー

「Xcode」MCPサーバーは何をする？

Xcode MCP（Model Context Protocol）サーバーは、AIアシスタントとXcode開発環境を橋渡しするための特化ツールです。Xcode関連の幅広い操作を標準化プロトコルで公開し、AIエージェントがXcodeプロジェクト管理、ファイル操作、iOSシミュレータ制御、各種依存関係やビルドツールとの連携を実現します。この深い統合により、ビルド・テスト・コード解析・依存関係管理（CocoaPodsやSwiftパッケージマネージャ）・シミュレータ制御などのタスクがプログラムやAIアシスタント経由で自動実行可能になります。繰り返し作業の自動化、コード品質向上、iOS/macOSプロジェクト開発の加速に特に有効で、強力なXcode機能を自然言語やAIインターフェースで活用できます。

プロンプト一覧

利用可能なリポジトリファイルやドキュメントにプロンプトテンプレートは記載されていません。

リソース一覧

利用可能なリポジトリファイルやドキュメントに明示的な（MCPで定義された）リソースは記載されていません。

ツール一覧

• プロジェクト管理ツール

  • アクティブプロジェクトの設定・情報取得
  • テンプレートから新規Xcodeプロジェクト作成（例：iOS、macOS）
  • ファイルをターゲット・グループ指定でプロジェクトに追加
  • ワークスペースドキュメント解析とスキーム一覧取得

• ファイル操作

  • ファイルの読み書き（エンコーディング対応）
  • バイナリファイルのbase64処理
  • パターンや正規表現によるテキスト検索
  • ファイル存在・メタデータ確認
  • ディレクトリ自動作成

• ビルド＆テスト

  • カスタムオプション付きビルド
  • テスト実行と失敗レポート
  • コード解析
  • ビルドディレクトリのクリーン
  • 配布用アーカイブ作成

• CocoaPods連携

  • Podの初期化・インストール・更新・管理
  • Pod依存関係の追加/削除
  • 任意のpodコマンド実行

• Swiftパッケージマネージャ

  • Swiftパッケージ・依存関係管理
  • パッケージの更新/解決
  • ドキュメント生成
  • パッケージのビルド・テスト

• iOSシミュレータツール

  • シミュレータの一覧・起動・終了
  • アプリのインストール・起動
  • スクリーンショット/ビデオキャプチャ
  • シミュレータ設定管理

• Xcodeユーティリティ

  • xcrunによるXcodeコマンド実行
  • アセットカタログのコンパイル
  • アプリアイコンセット生成
  • パフォーマンストレース
  • App Store用アーカイブのエクスポート/バリデーション
  • Xcodeバージョン切り替え

このMCPサーバーのユースケース

• 自動プロジェクトセットアップ
  AIエージェントが新規Xcodeプロジェクトを素早く作成・設定し、CocoaPodsやSwiftパッケージマネージャで依存関係も準備。ディレクトリ構成まで自動化し、初期化作業を大幅に短縮します。

• 継続的インテグレーションとテスト
  iOS/macOSプロジェクトのビルド・テスト・解析ワークフローを自動化。AI主導のルーチンでビルド/テスト実行や失敗・コード問題のレポートも可能となり、チャットやスクリプトから堅牢なCI/CDパイプラインを構築できます。

• シミュレータ管理とテスト
  iOSシミュレータをプログラム制御し、自動UIテストやアプリインストール、スクリーンショット/ビデオ取得なども自動化。モバイルアプリのテスト範囲と信頼性が向上します。

• 依存関係管理
  CocoaPodsやSwiftパッケージマネージャを使ったサードパーティライブラリの追加・削除・更新を効率化し、プロジェクトを常に最新・互換状態に保ちます。

• アセット＆ビルドユーティリティ
  アセットコンパイルやアイコン生成、ビルド成果物管理（アーカイブ・エクスポート・App Store提出）を自動化し、効率と正確性を高めます。

セットアップ方法

Windsurf

1. macOS、Xcode（14.0以上）、Node.js（16以上）、npmがインストールされていることを確認します。
2. xcode-mcp-serverリポジトリをダウンロードまたはクローンします。
3. セットアップスクリプトを実行します:

   chmod +x setup.sh
   ./setup.sh
   

4. Windsurfの設定ファイルを編集し、MCPサーバーを追加します:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 設定を保存してWindsurfを再起動します。Xcode MCPツールの利用可能性を確認してください。

Claude

1. 前提条件（macOS、Xcode、Node.js、npm）をインストールします。
2. リポジトリをクローンし、上記と同様にセットアップスクリプトを実行します。
3. ClaudeのMCP設定ファイルを探します。
4. Xcode MCPサーバーを追加します:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 保存してClaudeを再起動し、ツール一覧でセットアップを確認します。

Cursor

1. すべての依存関係がインストール済みであることを確認します。
2. リポジトリをクローンしてセットアップスクリプトを実行します。
3. CursorのMCP設定ファイルを開きます。
4. mcpServersの下に以下を追加します:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 保存してCursorを再起動し、サーバーがアクティブか確認します。

Cline

1. 前提条件をセットアップし、セットアップスクリプトを実行します。
2. ClineのMCPサーバー設定ファイルを編集します。
3. Xcode MCPサーバーの項目を挿入します:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

4. 変更を保存してClineを再起動します。
5. Cline内でXcode MCPサーバーが動作していることを確認します。

環境変数によるAPIキーのセキュリティ管理

• 機密データ（APIキーやトークン）は.envファイルに記載してください。
• .env利用例:

  XCODE_MCP_API_KEY=your_api_key_here
  

• 設定内で環境変数を参照できます:

  {
    "mcpServers": {
      "xcode-mcp": {
        "command": "npx",
        "args": ["@xcode/mcp-server@latest"],
        "env": {
          "XCODE_MCP_API_KEY": "${XCODE_MCP_API_KEY}"
        },
        "inputs": {
          "projectBaseDir": "/Users/yourname/Projects"
        }
      }
    }
  }
  

フロー内でこのMCPを使う方法

FlowHuntでMCPを利用する

FlowHuntのワークフローにMCPサーバーを組み込むには、まずフローにMCPコンポーネントを追加し、AIエージェントと接続します。

MCPコンポーネントをクリックして設定パネルを開きます。システムMCP設定セクションに、以下のJSON形式でMCPサーバー情報を入力します。

{
  "xcode-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AIエージェントはこのMCPの全機能をツールとして利用できるようになります。“MCP-name"は実際のMCPサーバー名（例：“xcode-mcp”）に、URLもご自身のMCPサーバーURLに置き換えてください。

概要

上記情報から、Xcode MCPサーバーはXcode自動化機能が非常に充実していますが、プロンプトテンプレートや明示的MCPリソース、サンプリング/roots機能のドキュメントがありません。プロジェクト・ビルド系ツールやセットアップ解説は高評価です。

MCPスコア

総合評価として、このMCPサーバーは10点中7点です。
Xcode統合や自動化ツールが充実し、セットアップ手順やライセンスも明快です。ただしプロンプトテンプレートやリソース、rootsやサンプリングサポートといった、MCP完全準拠や高度なワークフローに必要な情報が不足しています。