mcp-tools

Swift／Apple ワークフローを支える 2 つの MCP サーバーについて説明します。Xcode プロジェクトの自動化、ビルド検証、シミュレーター上での UI 検証を行う XcodeBuildMCP（プロジェクトの検出、シミュレーターでのビルド／実行／テスト、スクリーンショット、実行時 UI スナップショット、外観設定、自律的なビルド・修正・再ビルドのループ）と、公式ドキュメントを扱う Apple Docs MCP（すべてのフレームワーク、シンボルの詳細、利用可能状況／非推奨情報、サンプルコード、2014～2025 年の WWDC トランスクリプトを同梱。新しいセッションは developer.apple.com から参照）を紹介します。

必須の調査優先順位（最初に Apple Docs MCP、次にサードパーティライブラリ向けの Context7、最後に Exa のウェブ検索）と、コード変更のたびに必ず行うビルド検証ループ（ビルド、エラーの確認、修正、再ビルド。エラーがゼロの場合のみコミット）を定義します。

両サーバーのインストール用スニペットと、タスクに適したツールを対応付けたクイックリファレンステーブルを掲載します。

Swift 開発向け MCP ツール

Swift／Xcode ワークフローを強化する Model Context Protocol サーバー。

利用可能な MCP サーバー

1. XcodeBuildMCP

目的：Xcode プロジェクトの自動化とビルド検証

ドキュメント：xcodebuild-mcp.md、xcodebuild-mcp-ui-verification.md

主な機能：

• Xcode プロジェクトとワークスペースを検出
• シミュレーター、デバイス、macOS でビルド／実行／テスト（build_run_sim、test_sim）
• スキームの一覧表示とビルド設定の確認
• クリーンビルドと Derived Data の削除
• UI 検証用の screenshot と snapshot_ui（デフォルトのワークフロー）。オプションのワークフローでは外観設定やタップも可能
• 自律的なビルド検証（AI がビルドし、エラーを確認・修正して再ビルドできます）

インストール：

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": ["-y", "xcodebuildmcp@latest"]
    }
  }
}

次の場合に使用：

• コード変更後（検証必須）
• ビルドの問題をデバッグするとき
• 新しい Xcode プロジェクトを作成するとき
• 古いビルドをクリーンアップするとき

---

2. Apple Docs MCP

目的：WWDC にオフラインでアクセスできる Apple の公式ドキュメント

ドキュメント：apple-docs-mcp.md、apple-docs-mcp-workflows.md

主な機能：

• すべての Apple フレームワークを検索（SwiftUI、UIKit、Foundation など）
• シンボル（クラス、メソッド、プロパティ）の詳細情報を取得
• 2014～2025 年の WWDC セッションをオフラインで同梱。新しいセッションは developer.apple.com/videos から参照
• Apple のサンプルコードにアクセス
• フレームワークの調査と検出
• API の利用可能状況と非推奨情報の確認

インストール：

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

次の場合に使用：

• Apple API を調査するとき（Context7 より優先）
• WWDC のベストプラクティスを探すとき
• API の利用可能状況を確認するとき
• 公式のコード例を取得するとき

---

ワークフローへの統合

調査を先に行う（必須）

Priority order:
1. ⭐ Apple Docs MCP (official Apple docs + WWDC)
2. Context7 (third-party libraries)
3. Exa web search (community tutorials)

ビルド検証（必須）

After EVERY code change:
1. XcodeBuildMCP: Build project
2. If errors → Read error messages
3. Fix issues
4. Rebuild to validate
5. Only commit if zero errors

---

開発ワークフロー全体（2026）

1. Feature request received
   ↓
2. Apple Docs MCP: Search API/WWDC
   ↓
3. Read existing codebase (DRY principle)
   ↓
4. Implement following Apple patterns
   ↓
5. XcodeBuildMCP: Build to validate ⭐
   ↓
6. If build errors:
   - Read error messages
   - Fix issues
   - Rebuild
   ↓
7. Run tests (if available)
   ↓
8. UI changed? HIG verification gate on simulator
   (xcodebuild-mcp-ui-verification.md)

---

利点

XcodeBuildMCP

✅ エラーを自律的に検出して修正 ✅ コンパイルエラーを一切許容しない ✅ 増分ビルドを非常に高速に実行 ✅ プロジェクトのひな形作成を自動化 ✅ コミット前にビルドを検証

Apple Docs MCP

✅ Apple の公式ドキュメント（最も正確） ✅ WWDC セッションをオフラインで利用可能（2014～2025 年分を同梱） ✅ 非推奨情報と利用可能状況を確認可能 ⚠️ HIG ページと 2025 年以降の WWDC は含まれません。browser_fetch で developer.apple.com を参照してください

---

リソース

XcodeBuildMCP：

• ウェブサイト（リポジトリは getsentry に移動しました）
• npm
• バージョン：2.7.0（npm）

Apple Docs MCP：

• GitHub
• npm

---

Quick Reference

Task	MCP Tool	Documentation
Search Apple API	apple-docs	apple-docs-mcp.md
Find WWDC session	apple-docs	apple-docs-mcp.md
Get code example	apple-docs	apple-docs-mcp.md
Research workflow	apple-docs	apple-docs-mcp-workflows.md
Build project	XcodeBuildMCP	xcodebuild-mcp.md
Validate changes	XcodeBuildMCP	xcodebuild-mcp.md
Clean build	XcodeBuildMCP	xcodebuild-mcp.md
Create project	XcodeBuildMCP	xcodebuild-mcp.md
Verify UI (HIG gate)	XcodeBuildMCP	xcodebuild-mcp-ui-verification.md