mcp-tools

介绍支撑 Swift/Apple 工作流的两个 MCP 服务：XcodeBuildMCP 用于 Xcode 项目自动化、构建验证和模拟器内 UI 验证（发现项目、在模拟器上构建/运行/测试、截屏、运行时 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 项目和工作区
• 在模拟器（build_run_sim、test_sim）、设备和 macOS 上构建/运行/测试
• 列出 scheme 并显示构建设置
• 清理构建产物和派生数据
• 使用 screenshot + snapshot_ui 验证 UI（默认工作流）；通过可选工作流设置外观并执行点击
• 自主构建验证（AI 可构建、读取错误、修复并重新构建）

安装：

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

适用场景：

• 更改代码后（强制验证）
• 调试构建问题
• 创建新的 Xcode 项目
• 清理过时的构建产物

---

2. Apple Docs MCP

用途：提供官方 Apple 文档和离线 WWDC 内容

文档：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