Xcodeproj MCP Server

🚀 xcodeproj-mcp-server

xcodeproj-mcp-serverは、Swiftを使用してXcodeプロジェクトファイル（.xcodeproj）を操作するためのModel Context Protocol (MCP)サーバーです。このサーバーを使用することで、Xcodeプロジェクトの作成や管理、設定の変更などのタスクを自動化することができます。

⚠️ 重要提示

この製品は開発段階にあり、近日公開予定です。

🚀 クイックスタート

xcodeproj-mcp-serverは、Xcodeプロジェクトファイルをプログラムで操作するためのツールを提供するMCPサーバーです。このサーバーは、tuist/xcodeprojライブラリを利用して信頼性の高いプロジェクトファイル操作を行い、swift-sdkを使用してModel Context Protocolを実装しています。

このサーバーを使用すると、AIアシスタントや他のMCPクライアントが以下のことを行うことができます。

• 新しいXcodeプロジェクトを作成する
• ターゲット、ファイル、ビルド構成を管理する
• ビルド設定を変更する
• 依存関係やフレームワークを追加する
• 一般的なXcodeプロジェクトタスクを自動化する

📦 インストール

前提条件

• macOS 14.0以降
• Xcode 16.4以降

インストール手順

まず、リポジトリをクローンし、リリースモードでプロジェクトをビルドします。

git clone https://github.com/giginet/xcodeproj-mcp-server.git
cd xcodeproj-mcp-server
swift build -c release

Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "xcodeproj": {
      "command": "/path/to/xcodeproj-mcp-server/.build/release/xcodeproj-mcp-server"
    }
  }
}

/path/to/xcodeproj-mcp-serverを、実際にリポジトリをクローンしたパスに置き換えてください。

Claude Codeの設定

# ローカル実行可能ファイルを使用してMCPサーバーを追加する
$ claude mcp add --name xcodeproj --command "/path/to/xcodeproj-mcp-server/.build/release/xcodeproj-mcp-server"

/path/to/xcodeproj-mcp-serverを、実際にリポジトリをクローンしたパスに置き換えてください。

💻 使用例

利用可能なツール

プロジェクト管理

• create_xcodeproj - 新しいXcodeプロジェクトを作成する

  • パラメータ: project_name, path, organization_name, bundle_identifier

• list_targets - プロジェクト内のすべてのターゲットをリストする

  • パラメータ: project_path

• list_build_configurations - すべてのビルド構成をリストする

  • パラメータ: project_path

• list_files - プロジェクト内のすべてのファイルをリストする

  • パラメータ: project_path

ファイル操作

• add_file - プロジェクトにファイルを追加する

  • パラメータ: project_path, file_path, target_name, group_path

• remove_file - プロジェクトからファイルを削除する

  • パラメータ: project_path, file_path

• move_file - プロジェクト内でファイルを移動またはリネームする

  • パラメータ: project_path, source_path, destination_path

• create_group - プロジェクトナビゲーターに新しいグループを作成する

  • パラメータ: project_path, group_name, parent_group_path

ターゲット管理

• add_target - 新しいターゲットを作成する

  • パラメータ: project_path, target_name, type, platform, bundle_identifier

• remove_target - 既存のターゲットを削除する

  • パラメータ: project_path, target_name

• duplicate_target - 既存のターゲットを複製する

  • パラメータ: project_path, source_target_name, new_target_name

• add_dependency - ターゲット間の依存関係を追加する

  • パラメータ: project_path, target_name, dependency_name

ビルド構成

• get_build_settings - ターゲットのビルド設定を取得する

  • パラメータ: project_path, target_name, configuration_name

• set_build_setting - ビルド設定を変更する

  • パラメータ: project_path, target_name, setting_name, value, configuration_name

• add_framework - フレームワーク依存関係を追加する

  • パラメータ: project_path, target_name, framework_name, embed

• add_build_phase - カスタムビルドフェーズを追加する

  • パラメータ: project_path, target_name, phase_type, name, script

ユーティリティ

• open_xcodeproj - XcodeでXcodeプロジェクトを開く
  • パラメータ: project_path, wait (オプション)

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。