mcp-tools について
SwiftとXcode開発向けのMCPツールガイドで、XcodeBuildMCPとApple Docs MCPの機能やワークフローを説明します。Apple公式資料を優先して調査し、コード変更のたびにビルド検証を行う手順を定めています。
主な機能
- 01Xcodeプロジェクトの検出とビルド
- 02プロジェクト作成とビルド管理
- 03Apple APIとWWDC資料の検索
- 04APIの利用可否と非推奨状態の確認
- 05調査とビルド検証の手順定義
活用シーン
- 01Swiftコード変更のビルドと検証
- 02Xcodeプロジェクトのビルドエラー調査
- 03Apple APIとWWDCのサンプル検索
- 04テンプレートからのXcodeプロジェクト作成
MCP 対応
XcodeBuildMCPはXcodeプロジェクトの自動化とビルド検証を、Apple Docs MCPはApple公式ドキュメント、シンボル、サンプルコード、WWDCコンテンツの検索を担うMCPサーバーとして紹介されています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ fusengine/ agents --skill mcp-toolsインストール後、Claude Code で/mcp-toolsを入力して読み込まれたか確認します。
同梱ファイルreferences/apple-docs-mcp.mdreferences/xcodebuild-mcp.md
詳細
必須の「調査優先」順序(まず Apple Docs MCP、次にサードパーティライブラリ向けの Context7、最後に Exa のウェブ検索)と、コード変更のたびに必ず行うビルド検証ループ(ビルド、エラーの確認、修正、再ビルド。エラーがゼロの場合にのみコミット)を定めています。
両サーバーのインストールスニペットと、タスクに適切なツールを対応付けるクイックリファレンステーブルを含みます。
Swift 開発向け MCP ツール
Swift/Xcode ワークフローを強化する Model Context Protocol サーバー。
利用可能な MCP サーバー
1. XcodeBuildMCP
目的:Xcode プロジェクトの自動化とビルド検証
ドキュメント:xcode-build-mcp.md
主な機能:
- Xcode プロジェクトとワークスペースを検出
- macOS、iOS Simulator、iOS Device 向けにビルド
- スキームの一覧表示とビルド設定の表示
- ビルドと派生データをクリーン
- テンプレートから新しいプロジェクトを作成
- 自律的なビルド検証(AI がビルド、エラーの確認、修正、再ビルドを実行)
インストール:
{
"mcpServers": {
"XcodeBuildMCP": {
"command": "npx",
"args": ["-y", "xcodebuildmcp@latest"]
}
}
}
使用する場面:
- コード変更後(必須の検証)
- ビルドの問題のデバッグ
- 新しい Xcode プロジェクトの作成
- 古いビルドのクリーン
2. Apple Docs MCP
目的:オフラインで WWDC にアクセスできる公式 Apple ドキュメント
ドキュメント:apple-docs-mcp.md
主な機能:
- すべての Apple フレームワークを検索(SwiftUI、UIKit、Foundation など)
- シンボルの詳細情報を取得(クラス、メソッド、プロパティ)
- 2014〜2025 年の WWDC セッション(完全なトランスクリプト付き、オフライン)
- 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. Commit changes
メリット
XcodeBuildMCP
✅ エラーの自律的な検出と修正 ✅ コンパイルエラーを一切許容しない ✅ 非常に高速なインクリメンタルビルド ✅ プロジェクトのひな形作成を自動化 ✅ コミット前のビルド検証
Apple Docs MCP
✅ Apple の公式ドキュメント(最も正確) ✅ WWDC セッションをオフラインで利用(2014〜2025 年) ✅ ネットワーク遅延ゼロ ✅ API を網羅 ✅ 非推奨情報と利用可能状況の情報
リソース
XcodeBuildMCP:
Apple Docs MCP:
クイックリファレンス
| タスク | MCP ツール | ドキュメント |
|---|---|---|
| Apple API を検索 | apple-docs | apple-docs-mcp.md |
| WWDC セッションを探す | apple-docs | apple-docs-mcp.md |
| コード例を取得 | apple-docs | apple-docs-mcp.md |
| プロジェクトをビルド | XcodeBuildMCP | xcode-build-mcp.md |
| 変更を検証 | XcodeBuildMCP | xcode-build-mcp.md |
| ビルドをクリーン | XcodeBuildMCP | xcode-build-mcp.md |
| プロジェクトを作成 | XcodeBuildMCP | xcode-build-mcp.md |