mcp-tools

介绍为 Swift/Apple 工作流提供支持的两个 MCP 服务：用于 Xcode 项目自动化和构建验证的 XcodeBuildMCP（发现项目、为 macOS/iOS Simulator/设备构建、列出方案、清理构建、搭建新项目，以及自主执行构建—修复—重建循环），以及提供离线 WWDC 访问能力的 Apple Docs MCP（所有框架、符号详情、2014-2025 年 WWDC 会议及其文字稿、示例代码、API 可用性/弃用信息）。

定义强制性的研究优先顺序（首先使用 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 设备构建
• 列出方案并显示构建设置
• 清理构建和派生数据
• 根据模板创建新项目
• 自主构建验证（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：

• GitHub
• npm
• 版本：2.7.0（npm，2026 年 9 月）

Apple Docs MCP：

• GitHub
• npm

---

快速参考

任务	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