local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Facilitates iOS app development by providing build and test capabilities for iOS simulator targets, with default configuration for iPhone 15 Pro simulator.
Enables building and testing Xcode projects with the ability to specify schemes, configurations, and destinations. Supports running specific tests, generating code coverage reports, and accessing build and test logs.

Xcode MCP サーバー

Xcode MCPサーバーは、Xcodeプロジェクトのビルドとテストのためのモデルコンテキストプロトコルインターフェースを提供します。これにより、AIアシスタントは標準化されたインターフェースを介してビルドを直接トリガーし、テストを実行し、進捗状況を監視したり、ログにアクセスしたりできるようになります。

特徴

カスタムスキームと構成でXcodeプロジェクトをビルドする
きめ細かな制御でユニットテストを実行する（特定のテストを実行するか、テストをスキップする）
コードカバレッジレポートを生成する
ビルドとテストのログをリアルタイムでストリーミング
詳細なビルドおよびテストレポートにアクセスする
JSON形式の出力
自動ログ永続化

要件

Node.js 16以上
Xcode コマンドラインツール
タイプスクリプト
MCP 互換クライアント (例: Claude Desktop)

インストール

# Clone the repository
git clone https://github.com/PolarVista/Xcode-mcp-server.git
cd xcode-mcp-server

# Install dependencies
npm install

# Build the server
npm run build

Claude Desktopでの使用

サーバーを起動します。
npm run start /path/to/build/logs/directory
Claude Desktop の設定:
"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" }

利用可能なツール

ビルドプロジェクト

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

パラメータ:

projectPath (必須): .xcodeproj または .xcworkspace へのパス
scheme （必須）: ビルドスキーム名
configuration （オプション）：ビルド構成（デバッグ/リリース、デフォルトはデバッグ）
destination (オプション): ビルド先 (デフォルトは "platform=iOS Simulator,name=iPhone 15 Pro")

Claude での使用例:

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

実行テスト

オプションのフィルタリングを使用して単体テストを実行します。

パラメータ:

projectPath (必須): .xcodeproj または .xcworkspace へのパス
scheme （必須）: テストスキーム名
testIdentifier (オプション): 実行する特定のテスト (例: 'MyTests/testExample')
skipTests (オプション): スキップするテスト識別子の配列
configuration （オプション）：ビルド構成（デバッグ/リリース、デフォルトはデバッグ）
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レポート（ report-[timestamp].txt ）
テスト操作により以下が作成されます。
- テストログ ( test-[timestamp].log )
- JSON形式のログ ( test-[timestamp].log.json )
- テストレポート ( test-report-[timestamp].txt )
- コードカバレッジレポート ( coverage-[timestamp].txt )
最新のログ（ビルドまたはテスト）はxcode-build://latest-logリソースからアクセスできます。

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

AI アシスタントが標準化されたインターフェースを介して Xcode プロジェクトを直接構築およびテストできるようにするモデルコンテキストプロトコルサーバー。テストの実行、進行状況の監視、ログへのリアルタイムアクセスなどの機能を備えています。

Related Resources

Reddit Discussion about this server

Xcode MCP Server