xc MCP

xc-mcp

Mac上Swift开发的详尽MCP服务器。在模拟器、物理设备和Mac本身上构建、测试、运行和调试iOS和macOS应用程序，使用200个工具进行项目操作、LLDB调试、UI自动化、仪器分析、内存诊断、崩溃符号化、公证、本地化、图标组合和SwiftUI预览捕获。

我开始研究这个问题是因为我尝试过的每一个类似的MCP都崩溃了，或者更糟糕的是，破坏了复杂项目的配置（多个目标、多个平台、依赖类型的混合）。我还认为，如果它是用Swift而不是TypeScript或Python编写的，那就太好了。

小心点

这个项目 快速迭代要达到这一点，必须解决相当复杂的问题，这既令人放心，也令人不安。有很好的linting和强大的测试，包括实际的开源Swift项目的夹具，但没有真正的QA过程。与任何代理工作一样，在发布kraken之前，确保您的文件已提交或以其他方式备份。

建立在

• \_显示提示 --项目文件操作
• modelcontextprotocol/swift-sdk --MCP实施
• 本土的 xcodebuild, simctl, devicectl, lldb，以及 xctrace --常见的嫌疑人

______________________________________________________________________

里面有什么

九种工具类别。使用单片服务器来处理所有事情，或者混合使用集中式服务器来降低令牌开销。

再加上中描述的一些跨领域功能 显著权力.

______________________________________________________________________

安装

自制（推荐）

brew tap toba/tap
brew install xc-mcp

来源

git clone https://github.com/toba/xc-mcp.git
cd xc-mcp
swift build -c release

配置

克劳德代码：

# With Homebrew
claude mcp add xc-mcp -- $(brew --prefix)/bin/xc-mcp

# From source
claude mcp add xc-mcp -- /path/to/xc-mcp/.build/release/xc-mcp

克劳德桌面版 --添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "xc-mcp": {
      "command": "/opt/homebrew/bin/xc-mcp"
    }
  }
}

对于Intel Mac，请使用 /usr/local/bin/xc-mcp 相反。

需求

• macOS 15+
• Xcode（for xcodebuild, simctl, devicectl)
• 某些工具需要macOS隐私权限——请参阅 权限

______________________________________________________________________

多服务器架构

使用所有工具运行单个服务器，或使用集中服务器来减少令牌开销。每个工具都在 xc-mcp；聚焦服务器是严格的子集。

Configuration presets

// Minimal (~9K tokens) — project editing only
{
  "mcpServers": {
    "xc-project": { "command": "/opt/homebrew/bin/xc-project" }
  }
}

// Standard (~19K tokens) — project + simulator + build
{
  "mcpServers": {
    "xc-project": { "command": "/opt/homebrew/bin/xc-project" },
    "xc-simulator": { "command": "/opt/homebrew/bin/xc-simulator" },
    "xc-build": { "command": "/opt/homebrew/bin/xc-build" }
  }
}

// Full (~27K tokens) — all capabilities
{
  "mcpServers": {
    "xc-project": { "command": "/opt/homebrew/bin/xc-project" },
    "xc-simulator": { "command": "/opt/homebrew/bin/xc-simulator" },
    "xc-device": { "command": "/opt/homebrew/bin/xc-device" },
    "xc-debug": { "command": "/opt/homebrew/bin/xc-debug" },
    "xc-swift": { "command": "/opt/homebrew/bin/xc-swift" },
    "xc-build": { "command": "/opt/homebrew/bin/xc-build" }
  }
}

______________________________________________________________________

显著权力

有几件事值得一提，因为它们不寻常、不明显，或者是这个项目存在的原因。

截图任何macOS应用程序窗口 — screenshot_mac_window 使用ScreenCaptureKit按应用程序名称、捆绑包ID或标题捕获任何窗口。无需模拟器。配对 debug_view_borders 查看布局问题。

语义化macOS UI自动化 --The interact_* 工具使用辅助功能API单击“保存”而不是像素坐标。转储UI树、单击按钮、读取值、导航菜单、键入文本。适用于任何正在运行的macOS应用程序。

SwiftUI预览截图 — preview_capture 提取物 #Preview 拦截、生成临时主机应用程序、构建并启动它、截图和清理。处理可合并库、SPM传递依赖关系、中的本地包 Packages/，以及导致编译器崩溃的嵌套结构预览。

MCP上的完整LLDB --由伪TTY支持的持久会话。断点在工具调用中仍然存在。完整调试器减去GUI。

在运行中的应用程序上绘制视图边框 — debug_view_borders 注入彩色 CALayer 通过LLDB将边界添加到每个视图中。无代码更改，无重启。

存储器诊断 --包装材料 leaks, heap, vmmap, stringdups，以及 malloc_history --埋在Developer目录中的那些大多数人都不知道存在。LLM是 *特别* 擅长这些，因为输出是密集的、重复的，并且需要有人（某事？）来总结。

一个呼叫设备部署 — build_deploy_device 构建→ stop → 安装→ 在一次工具调用中启动。没有四步舞。

Xcode状态同步 — sync_xcode_defaults 从Xcode的用户状态读取您的活动方案并运行目标。打开一个项目，选择你的方案，让代理继承它。

图标编辑器捆绑包 --满 .icon 无需打开Icon Composer即可创建和编辑捆绑包——图层、填充、玻璃效果、暗模式。通过渲染 ictool.

未使用代码检测 --包装材料 外围。返回一个持久的清单，代理可以在清理时标记出来。

动态工具工作流程 — manage_workflows 在运行时启用或禁用工具类别，这样当您只需要六个工具时，187个工具就不会都放在上下文中。

______________________________________________________________________

类别详细信息

下面的每一节都描述了一个突出显示的工具类别，然后扩展到完整的工具参考。

______________________________________________________________________

调试

24个工具。由伪TTY支持的LLDB会话——断点在工具调用中存活，快速连接/分离不会挂起。加上独立的内存诊断和崩溃符号，适用于任何正在运行的进程。

Build & attach

Breakpoints, watchpoints & execution

Inspection

Memory diagnostics

独立的CLI包装器——通过PID或捆绑包ID处理任何正在运行的进程。

______________________________________________________________________

macOS构建和屏幕截图

14个工具。构建、测试、运行、截图macOS应用程序。覆盖率报告、性能基线、启动分析和构建诊断。

All tools

SwiftUI预览捕获 （1个工具）：

______________________________________________________________________

模拟器

25个工具。模拟器管理、构建和运行以及基于协调的触摸自动化 simctl io.

Simulator management

Touch & gesture automation

______________________________________________________________________

设备

9个工具。物理iOS设备管理，包括一个呼叫部署管道。

All tools

______________________________________________________________________

项目管理

58个工具。满的 .xcodeproj 操作——目标、组、文件、方案、测试计划、Swift包、同步文件夹、构建阶段、文档类型、URL类型。在XcodeProj库中，没有 xcodebuild 需要。

Files & groups

Targets

Build settings & phases

Schemes & test plans

Swift packages

Synchronized folders

Document types & URL schemes

______________________________________________________________________

图标组成

9个工具。创建和编辑苹果图标编辑器 .icon 捆绑——具有填充、玻璃效果、阴影、半透明和暗模式变体的多层图标。通过以下方式渲染为PNG ictool.使用正确的代码添加到Xcode项目中 lastKnownFileType.

All tools

______________________________________________________________________

Swift软件包

12个工具。SPM操作、格式化、linting和未使用代码检测。

All tools

______________________________________________________________________

本地化

24个工具。苹果的完整CRUD .xcstrings 格式——密钥、翻译、覆盖率统计、过时密钥检测。批处理操作是原子操作。

Read operations

Write operations

______________________________________________________________________

会话和实用程序

12个工具。从工作目录中自动检测项目路径——服务器从 cwd 寻找 Package.swift, .xcodeproj，或 .xcworkspace.

Session management

Discovery

Distribution & diagnostics

Instruments

Logging

______________________________________________________________________

macOS权限

某些工具需要通过以下方式授予macOS隐私权限 系统设置>隐私和安全:

macOS将这些授权给 负责任的过程 --位于流程树顶部的GUI应用程序，而不是 xc-mcp 本身。所以 克劳德桌面版, VS代码/光标，或你的 终端模拟器 需要许可。这 xc-mcp 二进制文件不会出现在系统设置中——TCC总是解析到父GUI应用程序。

生成输出解析

测试工具解析两者 XCTest 和 快速测试 输出格式，提取具有测试名称、持续时间和失败详细信息的结构化通过/失败结果。处理并行输出、回溯转义函数名、SF符号前缀和故障摘要。

测试

826个测试——使用内存夹具和模拟运行器进行快速单元测试，以及构建和截图真实开源项目的集成测试。

# Unit tests (fast, no Xcode projects needed)
swift test

# Integration tests (requires fixture repos)
./scripts/fetch-fixtures.sh   # ~1 minute, idempotent
swift test --filter Integration

路径安全

当提供基路径作为命令行参数时，所有文件操作都仅限于该目录。

许可证

MIT许可证。看 许可证 了解详情。