Xcode MCP Server

🚀 Xcode MCP サーバ

Xcode MCP サーバは、LLM アプリケーションから直接 Xcode プロジェクトを構築するためのモデルコンテキストプロトコルサーバです。標準化されたインターフェースを通じて、AI アシスタントが構築のトリガー、テストの実行、進捗の監視、ログのアクセスを直接行うことができます。

✨ 主な機能

• カスタムスキームと設定を使用して Xcode プロジェクトを構築する
• ユニットテストを実行する（特定のテストの実行や一部のテストのスキップなどの細かい制御に対応）
• コードカバレッジレポートを生成する
• 構築とテストのログをリアルタイムでストリーミングする
• 詳細な構築とテストのレポートにアクセスする
• JSON 形式で出力する
• ログを自動的に永続化する

📦 インストール

前提条件

• Node.js バージョン 16 以上
• Xcode コマンドラインツール
• TypeScript
• MCP 対応のクライアント（例: Claude Desktop）

インストール手順

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

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

# サーバをビルドする
npm run build

💻 使用例

Claude Desktop との連携

1. サーバを起動する：

   npm run start /path/to/build/logs/directory
   

2. Claude Desktop の設定で：

   "xcode-build": {
          "command": "node",
          "args": ["/path/to/the/xcode-mcp-server/build/index.js",
                   "/path/to/your/project/folder"],
          "env": {
            "PATH": "/usr/bin:/bin:/usr/local/bin:/usr/sbin:/sbin"
      }
   

利用可能なツール

build_project

指定されたパラメータを使用して Xcode プロジェクトを構築します。

パラメータ:

• projectPath（必須）：.xcodeproj または .xcworkspace ファイルのパス
• scheme（必須）：ビルドスキームの名前
• configuration（オプション）：ビルド構成（Debug/Release、デフォルトは Debug）
• destination（オプション）：ビルドターゲット（デフォルトは "platform=iOS Simulator,name=iPhone 15 Pro"）

Claude での使用例:

build_project({
  projectPath: "/path/to/Project.xcodeproj",
  scheme: "MyApp",
  configuration: "Debug"
})

run_tests

ユニットテストを実行し、オプションでフィルタリングを行うことができます。

パラメータ:

• projectPath（必須）：.xcodeproj または .xcworkspace ファイルのパス
• scheme（必須）：テストスキームの名前
• testIdentifier（オプション）：特定のテストケースの ID（例: 'MyTests/testExample'）
• skipTests（オプション）：スキップするテスト識別子の配列
• configuration（オプション）：ビルド構成（Debug/Release、デフォルトは Debug）
• destination（オプション）：テストターゲット（デフォルトは "platform=iOS Simulator,name=iPhone 15 Pro"）

Claude での使用例:

run_tests({
  projectPath: "/path/to/Project.xcodeproj",
  scheme: "MyAppTests",
  testIdentifier: "LoginTests/testSuccessfulLogin",
  skipTests: ["PerformanceTests/testLargeDataLoad"],
  configuration: "Debug"
})

📚 ドキュメント

ログ

• すべてのログは指定されたベースディレクトリ内の build-logs/ ディレクトリに保存されます。
• ビルド操作では以下が生成されます：
  • テキストログ（build-[タイムスタンプ].log）
  • JSON 形式のログ（build-[タイムスタンプ].log.json）
  • Xcode レポート（report-[タイムスタンプ].txt）
• テスト操作では以下が生成されます：
  • テストログ（test-[タイムスタンプ].log）
  • JSON 形式のログ（test-[タイムスタンプ].log.json）
  • テストレポート（test-report-[タイムスタンプ].txt）
  • コードカバレッジレポート（coverage-[タイムスタンプ].txt）
• 最新のログ（ビルドまたはテスト）は xcode-build/[タイムスタンプ]/latest を通じてアクセスできます。