Polarvista Xcode MCP Server

🚀 Xcode MCP サーバ

大規模言語モデルアプリケーションから直接 Xcode プロジェクトを構築およびテストするための Model Context Protocol サーバ

Xcode MCP サーバは、Xcode プロジェクトの構築とテストに使用する Model Context Protocol インターフェースを提供します。これにより、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（オプション）：特定のテストの識別子（例: '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-[timestamp].log）
  • JSON 形式のログ（build-[timestamp].log.json）
  • Xcode レポート（build-[timestamp].xcresult）
• テスト操作では、以下のファイルが作成されます：
  • テキスト形式のログ（test-[timestamp].log）
  • JSON 形式のログ（test-[timestamp].log.json）
  • Xcode レポート（test-[timestamp].xcresult）

最新のビルドとテスト結果には、以下の URL からアクセスできます：

http://localhost:8080