Silbercueswift

SilbercueSwift

面向 iOS 开发，速度最快、功能最完整的 MCP 服务。一个 Swift 二进制文件，包含 58 个工具，零依赖。SilbercueSwift 拥有目前所有替代方案中最完整的工具集。

专为 Claude Code、Cursor 及所有兼容 MCP 的 AI Agent 打造。

正在寻找现有 iOS MCP 服务的替代方案？ SilbercueSwift 在一个二进制文件中涵盖了 XcodeBuildMCP、Appium-MCP 和 iosef 的全部功能，此外还支持 xcresult 解析、UI 自动化、代码覆盖率，以及快达 75 倍的屏幕截图。查看下方对比。

为什么选择 SilbercueSwift？

每个 iOS MCP 服务都面临同一个问题：原始的 xcodebuild 输出对 AI Agent 毫无用处。 500 行构建日志、被误认为错误的 stderr 噪声、没有结构化的测试结果。Agent 要花几分钟解析，而人类只需几秒就能看懂。

SilbercueSwift 解决了这个问题。它会解析 .xcresult 包——也就是 Xcode 内部使用的同一份结构化数据——并准确返回 Agent 所需的信息：通过／失败数量、包含文件:行号的失败消息、每个文件的代码覆盖率，以及失败截图。

你将获得	XcodeBuildMCP	Appium-MCP	iosef	SilbercueSwift
截图延迟	~1127ms	~77ms	~83ms	~316ms （ ~15ms，快 75 倍）
视图层级	~259ms	~938ms	~44ms	~31ms （ ~5ms）
查找元素	—	76ms	50ms	31ms （ <1ms + 自动滚动）
点击（坐标）	235ms	470ms	48ms	16ms （ 4ms）
滑动	1284ms	2685ms	262ms	~250ms
为模拟器构建	是	—	—	是
一次调用完成构建 + 运行	是（顺序执行）	—	—	是（并行执行，快约 9s）
结构化测试结果	部分支持	—	—	完整的 xcresult JSON
从 xcresult 导出失败截图	—	—	—	自动导出
每个文件的代码覆盖率	基础	—	—	可排序、可筛选
构建错误诊断	解析 stderr	—	—	包含文件:行号的 xcresult JSON
导航（查找 + 点击 + 验证）	—	—	—	1 次调用（~380ms）
双击	—	—	—	~60ms
拖放	—	仅支持坐标（3 次调用）	—	元素到元素（1 次调用）
滚动到元素	—	手动循环滑动	—	SmartScroll（1 次调用）
提醒框处理	—	单个提醒框	—	三级搜索 + 批量 accept_all
iOS 18 ContactsUI 对话框	—	—	—	支持
批量 UI 自动化	—	—	—	run_plan：支持自适应决策的多步骤计划
日志筛选	仅限子系统	—	部分支持	按主题筛选：减少 90% 的 token 消耗
每个失败测试的控制台日志	—	—	—	可选
等待日志模式	—	—	—	正则表达式 + 超时
视觉回归	—	—	—	基线 + 像素差异
多设备检查	—	—	—	深色模式、横屏、iPad
跨平台（Android）	—	是	—	—
工具	77（Rust）	61（Node.js + Appium）	15（Swift）	58（原生 Swift，8.5MB）
冷启动	~400ms	~1000ms	~100ms	~50ms

SilbercueSwift 的突出优势

截图速度最高可快 75 倍 — ~316ms（ ~15ms）

免费版截图速度（~316ms）快于 XcodeBuildMCP（~1127ms）和大多数替代方案。Pro 可将延迟降至 ~15ms——比 Appium 快 5 倍，比 XcodeBuildMCP 快 75 倍。无论使用哪个版本，Agent 都可以随意截图，无需担心额外开销。

从 xcresult 包获取结构化测试结果 — 失败原因一目了然 测试失败时，Agent 会获取错误消息、确切的文件:行号、失败状态的截图，以及可选的控制台输出——所有内容都从 Apple 的 .xcresult 格式中解析。无需从 500 行 xcodebuild stderr 中猜测。这就是“Agent 知道哪里出了问题”和“Agent 猜哪里出了问题”的区别。

单个二进制文件，零依赖 — 58 个工具，10 秒内安装

brew install silbercue/silbercue/silbercueswift — 完成。8.5MB 的原生 Swift 二进制文件。无需 Node.js、npm、Appium 服务、Python、Java、Rust 工具链。冷启动约需 50ms。这是启动 iOS MCP 服务最快的方式。

Agent 只读取关键信息 — 少用 90% 的 token，零浪费调用（主题过滤 ）

免费版已能过滤噪声：捕获时会排除 15 种已知噪声进程，并合并重复行（I/O 减少 79%）。Pro 增加了主题过滤功能——read_logs 将日志行归入 8 个主题，默认只显示应用和崩溃日志，并提供菜单：network(87) lifecycle(12) springboard(8)。Agent 只需一次调用即可打开指定主题——无需猜测，也无需反复尝试。

一次调用关闭所有权限对话框 — 一次往返处理 3 个提示

每个应用首次启动时都会显示 2–3 个权限对话框。其他服务要求 Agent 对每个对话框依次截图 → 找到按钮 → 点击。handle_alert(action: "accept_all") 只需一次调用即可关闭所有对话框，并在 SpringBoard、ContactsUI 和当前应用中查找。免费版可通过 accept / dismiss 逐个处理提示。

通过元素 ID 拖放 — 1 次调用，而非 3 次

“将项目 A 拖到项目 B 上方”只需一次调用：drag_and_drop(source_element: "el-0", target_element: "el-1")。竞品只支持原始坐标，因此 Agent 必须找到两个元素、提取它们的框架，并构建 W3C Actions 序列——至少需要 3 次调用。

自动滚动到屏幕外的元素 — 不再需要手动反复滑动

find_element(using: "accessibility id", value: "Save", scroll: true) 会自动滚动，直到元素出现。SmartScroll 支持 UIKit、SwiftUI 和延迟加载列表——无需猜测滚动方向。

约 31ms（免费版）/ 5ms（Pro）的视图层级检查 — 元素检查速度最高可快 188 倍

get_source 会在约 31ms（免费版）或 5ms（Pro）内返回完整 UI 树。最快的竞品需要 44ms，大多数需要 250ms 以上。这让 Agent 检查元素几乎不费成本。

一次调用完成导航 — 查找 + 点击 + 等待界面稳定 + 截图，约需 380ms

navigate(to: "Settings") 会找到元素并点击，等待界面稳定，然后返回验证截图——所有操作只需一次调用。没有竞品提供此功能。每个导航步骤都能为 Agent 节省 3–4 次工具调用。

批量 UI 自动化 — run_plan 可执行多步骤计划，并根据情况动态调整决策 run_plan 接收一系列 UI 步骤，并在服务端执行。若某个步骤需要判断（例如出现意外对话框、找不到元素），则会通过 4 个层级进行回退处理——从 MCP 采样到暂停并恢复。无需再为每次点击单独调用一次工具。

快速开始

使用 Homebrew 安装

brew tap silbercue/silbercue
brew install silbercueswift

或从源代码构建

git clone https://github.com/silbercue/SilbercueSwift.git
cd SilbercueSwift
swift build -c release
cp .build/release/SilbercueSwift /usr/local/bin/

在 Claude Code 中配置

只需一条命令，即可为所有项目全局安装：

claude mcp add --scope user SilbercueSwift /opt/homebrew/bin/SilbercueSwift

注意： 请使用完整路径（/opt/homebrew/bin/SilbercueSwift）。Claude Code 启动 MCP 服务时不会使用完整的 shell PATH，因此无法找到裸命令名称。

在 Cursor 中配置

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "SilbercueSwift": {
      "command": "/opt/homebrew/bin/SilbercueSwift"
    }
  }
}

在其他 MCP 客户端（Cline、Continue 等）中配置

任何支持 stdio MCP 服务的客户端：将其指向 /opt/homebrew/bin/SilbercueSwift，且不带参数。

卸载

claude mcp remove --scope user SilbercueSwift
brew uninstall silbercueswift
brew untap silbercue/silbercue

免费版与 Pro 版

SilbercueSwift 免费提供 49 个工具，可用于构建、测试、模拟、自动化 UI、捕获日志和截屏。无时限，无需注册。

Pro 版额外提供 9 个工具和更快的内部处理能力，适合需要全面功能的团队和高级用户。

	免费版	Pro 版
构建、测试、模拟器管理	49 个工具	58 个工具
截屏	~316ms	~15ms（快 75 倍）
结构化测试结果（xcresult）	支持	支持
查找元素	31ms	<1ms
查看层级结构	31ms	~5ms
点击（坐标）	16ms	4ms
点击 / 输入 / 滑动 / 双击 / 长按 / 拖放	支持	支持
导航（查找 + 点击 + 验证）	支持	支持
批量 UI 自动化（run_plan）	支持	支持
警报处理	单次接受/关闭	+ 批量 accept_all / dismiss_all
日志捕获	智能 + 详细	+ 应用模式、主题筛选
控制台捕获、git 工具	支持	支持
滚动到元素	—	SmartScroll
视觉回归	—	基线 + 像素差异
多设备检查	—	深色模式、横屏、iPad
辅助功能检查	—	动态字体大小渲染
本地化检查	—	多语言 + RTL
捏合 / 缩放	—	支持

Pro 版每月收费 12 EUR。在 Polar.sh 获取许可证，然后：

silbercueswift activate <YOUR-LICENSE-KEY>

14 个类别中的 58 个工具

构建（5 个工具）

工具	描述
build_sim	为 iOS Simulator 构建——返回结构化错误，并缓存 bundle ID 和应用路径
build_run_sim	一次调用完成构建 + 启动模拟器 + 安装 + 启动应用——并行两阶段流水线，比顺序执行快约 9 秒
clean	清理构建产物
discover_projects	查找 .xcodeproj/.xcworkspace 文件
list_schemes	列出可用的 scheme

测试与诊断（4 个工具）

工具	描述
test_sim	运行测试 + 结构化 xcresult 摘要（通过/失败/耗时）
test_failures	列出失败测试及错误消息、文件:行号和失败截图
test_coverage	按文件显示代码覆盖率，可排序和筛选
build_and_diagnose	构建 + 从 xcresult 获取结构化错误/警告

模拟器（12 个工具）

工具	描述
list_sims	列出可用模拟器
boot_sim	启动模拟器
shutdown_sim	关闭模拟器
install_app	安装 .app bundle
launch_app	通过 bundle ID 启动应用
terminate_app	终止正在运行的应用
clone_sim	克隆现有模拟器
erase_sim	清除模拟器内容和设置
delete_sim	删除模拟器
set_orientation	通过 WDA 旋转设备（PORTRAIT、LANDSCAPE_LEFT、LANDSCAPE_RIGHT）
sim_status	模拟器状态（已启动/已关闭、设备类型、运行时）
sim_inspect	模拟器详细信息（数据路径、日志路径、UDID）

UI 自动化（16 个工具）

原生手势输入，WDA 用于元素查询和警告 — 无需 Appium、Node.js 或 Python。

工具	描述	延迟
handle_alert	接受、关闭或批量处理系统和应用内警告	~200ms
find_element / find_elements	按辅助功能 ID、谓词、类链查找元素。scroll: true 会自动滚动，直到元素出现（SmartScroll — 3 种回退策略）	31ms ( <1ms)
click_element	点击 UI 元素	~75ms
tap_coordinates	基于坐标点击	~16ms ( ~4ms)
double_tap / long_press	在坐标处双击或长按	~60ms / ~1000ms
swipe	定向滑动	~250ms
pinch	放大/缩小	~400ms
drag_and_drop	从源位置拖到目标位置 — 元素到元素、坐标，或混合方式。为可重新排序的列表、看板和滑块提供智能默认设置	~1.3s
navigate	一次调用完成查找 + 点击 + 等待稳定 + 截图 — 减少 3-4 次往返	~380ms
type_text / get_text	在元素中输入或读取文本	~100-300ms
get_source	完整视图层级（JSON/XML）	~31ms ( ~5ms)
wda_status / wda_create_session	WDA 健康检查和会话管理	~50-100ms

handle_alert — 最智能的警告处理工具

# Accept a single alert with smart defaults
handle_alert(action: "accept")

# Dismiss with a specific button label
handle_alert(action: "dismiss", button_label: "Not Now")

# Batch-accept ALL alerts after app launch (unique to SilbercueSwift)
handle_alert(action: "accept_all")

三级警告搜索 — 在以下位置查找警告：

1. Springboard — 系统权限对话框（位置、相机、跟踪）
2. ContactsUI — iOS 18+ 联系人“有限访问”对话框（独立进程）
3. 当前应用 — 应用内 UIAlertController 对话框

智能默认选项 — 知道应该点击哪个按钮：

• 接受：“允许” → “使用 App 时允许” → “好” → “继续” → 最后一个按钮
• 关闭：“不允许”（可处理 Unicode U+2019）→ “取消” → “现在不” → 第一个按钮

批处理模式 — accept_all / dismiss_all 在服务端循环处理多个连续警告。只需一次 HTTP 往返，而不是 N 次。返回每个已处理警告的详细信息。

这些功能超出了其他 iOS MCP 服务目前提供的能力。

截图（1 个工具）

工具	延迟
screenshot	免费：~316ms / Pro：~15ms

日志（4 个工具）

工具	描述
start_log_capture	智能过滤的 os_log 流 — 3 种模式：smart（默认，启用主题过滤）、app（精简流，自动检测）、verbose（不过滤）。去除重复行。
stop_log_capture	停止捕获
read_logs	按主题过滤读取 — 默认仅包含应用和崩溃日志。响应中包含主题菜单及行数。通过 include 参数添加主题。
wait_for_log	等待符合正则表达式模式的日志，支持超时 — 无需使用 sleep() 变通处理

智能日志过滤 — 4 层过滤，零配置

# Start capture (default: smart mode — broad stream, topic filtering enabled)
start_log_capture()

# Read logs — default shows only app logs + crashes + topic menu
read_logs()
# → --- 230 buffered, 42 shown [app, crashes] ---
# → Topics: app(35) crashes(2) | network(87) lifecycle(12) springboard(8) widgets(0) background(3) system(83)
# → Hint: include=["network"] to add SSL/TLS + background transfer logs
# → ---
# → [42 filtered lines]

# Agent sees network(87) and wants SSL details — one call:
read_logs(include: ["network"])

# Narrow stream for production monitoring:
start_log_capture(mode: "app")

# Bypass mode logic with explicit predicate:
start_log_capture(subsystem: "com.apple.SwiftUI")

4 层过滤：

1. 流端噪声排除 — 缓冲前排除 15 个已知噪声进程以及子系统／类别。logd 中的服务端过滤可减少 79% 的 I/O。
2. 3 种采集模式 — smart（默认，广泛采集日志流以便按主题过滤）、app（精准采集，自动检测 bundle ID 和进程名称）、verbose（不进行过滤）。
3. 读取时按主题过滤 — read_logs 会将每一行缓冲日志归类到 8 个主题中（app、崩溃、网络、生命周期、SpringBoard、小组件、后台、系统）。默认仅显示 app 和崩溃。Agent 会根据需要添加主题 — 每次调用均为无状态。
4. 缓冲区去重 — 60 行相同的心跳日志会变成 2 行：日志本身，以及 ... repeated 59x。

8 个主题及针对 LLM 优化的菜单：

主题	匹配项	用例
app（始终启用）	子系统 == bundleId 或进程 == appName	你的 app：os_log、print()、NSLog()
crashes（始终启用）	fault 级别的日志	任意进程中的崩溃
network	trustd、nsurlsessiond	SSL/TLS 证书、后台传输
lifecycle	runningboardd、com.apple.runningboard.*	Jetsam、内存压力、应用被终止
springboard	SpringBoard	推送通知、应用状态
widgets	chronod	WidgetKit 时间线、刷新预算
background	com.apple.xpc.activity.*	BGTaskScheduler、后台抓取
system	其他所有内容	警告：日志量很大

控制台（3 个工具）

工具	描述
launch_app_console	启动应用并捕获标准输出／标准错误
read_app_console	读取控制台输出
stop_app_console	停止捕获控制台输出

Git（5 个工具）

工具	描述
git_status / git_diff / git_log	读取操作
git_commit / git_branch	写入操作

视觉回归（2 个工具）

工具	描述
save_visual_baseline	将屏幕截图保存为命名基线
compare_visual	将当前屏幕与基线进行比较 — 像素差异 + 匹配分数

多设备（1 个工具）

工具	描述
multi_device_check	在多个模拟器上运行视觉检查（深色模式、横屏、iPad）— 返回布局评分

无障碍功能（1 个工具）

工具	描述
accessibility_check	在不同动态字体内容大小类别下渲染屏幕 — 检测文本截断和布局问题

本地化（1 个工具）

工具	描述
localization_check	使用多种语言（包括 RTL 语言，如阿拉伯语、希伯来语）渲染屏幕 — 检测布局错乱

自动化（2 个工具）

工具	描述
run_plan	在服务端执行多步骤 UI 自动化计划 — 采用 4 层回退机制进行自适应决策
run_plan_decide	提供决策以恢复已暂停的计划 — 适用于不支持 MCP sampling 的客户端

会话（1 个工具）

工具	描述
set_defaults	设置默认项目、方案和模拟器 — 无需重复传递参数

xcresult 解析 — 核心功能

问题

每个 Xcode MCP 服务都会返回原始的 xcodebuild 输出。对于一次测试运行，这会产生 500 多行噪声。AI Agent 无法可靠地提取哪些测试失败以及失败原因。

解决方案

SilbercueSwift 使用 xcresulttool 解析 .xcresult bundle — 即 Xcode 的 Test Navigator 所使用的同一份结构化数据。

# One call, structured result
test_sim(project: "MyApp.xcodeproj", scheme: "MyApp")

→ Tests FAILED in 15.2s
  12 total, 10 passed, 2 FAILED
  FAIL: Login shows error message
    LoginTests.swift:47: XCTAssertTrue failed
  FAIL: Profile image loads
    ProfileTests.swift:112: Expected non-nil value

  Failure screenshots (2):
    /tmp/ss-attachments/LoginTests_failure.png
    /tmp/ss-attachments/ProfileTests_failure.png

  Device: iPhone 16 Pro (18.2)
  xcresult: /tmp/ss-test-1774607917.xcresult

Agent 会获得：

• 通过／失败数量 — 即时概览
• 包含文件:行号的失败消息 — 可直接采取行动
• 失败截图 — 视觉上下文（Claude 支持多模态）
• xcresult 路径 — 可用于 test_failures 或 test_coverage

深入分析失败

test_failures(xcresult_path: "/tmp/ss-test-*.xcresult", include_console: true)

→ FAIL: Login shows error message [LoginTests/testErrorMessage()]
    LoginTests.swift:47: XCTAssertTrue failed
    Screenshot: /tmp/ss-attachments/LoginTests_failure.png
    Console:
      [LoginService] Network timeout after 5.0s
      [LoginService] Retrying with fallback URL...
      ✘ Test "Login shows error message" failed after 6.2s

代码覆盖率

test_coverage(project: "MyApp.xcodeproj", scheme: "MyApp", min_coverage: 80)

→ Overall coverage: 72.3%

  Target: MyApp.app (74.1%)
      0.0% AnalyticsService.swift
     45.2% LoginViewModel.swift
     67.8% ProfileManager.swift

  Target: MyAppTests.xctest (62.0%)
     ...

基准测试

在 M3 MacBook Pro、iOS 26.4 模拟器上测得。所有数值均为预热 2 次后运行 5 次的中位数。

操作	iosef	XcodeBuildMCP	Appium-MCP	SS Free	SS Pro
截屏	83ms	1127ms	77ms	316ms	15ms
查找元素	50ms	N/A	76ms	31ms	<1ms
点击（坐标）	48ms	235ms	470ms	16ms	4ms
滑动	262ms	1284ms	2685ms	~250ms	~250ms
视图层级	44ms	259ms	938ms	31ms	5ms
导航（1 次调用）	—	—	—	~380ms	~380ms
双击	—	—	—	~84ms	~60ms
拖放	—	仅坐标	—	~1.3s	~1.3s
处理提示框	—	—	118ms	~200ms	~200ms
批量处理 3 个提示框	—	—	3 次调用	~800ms（1 次调用）	~800ms（1 次调用）
滚动到元素	—	—	滑动循环	—	自动
构建（干净构建）	—	2501ms	—	3188ms	1800ms
模拟器列表	12ms	567ms	—	15ms	15ms
冷启动	~100ms	~400ms	~1000ms	~50ms	~50ms
二进制大小	~5MB	~4MB	~200MB	8.5MB	8.5MB

与其他 MCP 服务的比较

请参阅上方的功能对比表，了解与 XcodeBuildMCP、Appium-MCP 和 iosef 的详细对比。这三个项目都非常出色，开创了 iOS MCP 工具。SilbercueSwift 将它们的功能集整合到一个原生二进制文件中，并实现了更深入的集成。唯一的取舍是：SilbercueSwift 仅支持 iOS（不支持 Android、watchOS、tvOS 或 visionOS）。

架构

SilbercueSwift (8.5MB Swift binary)
├── MCP SDK (modelcontextprotocol/swift-sdk)
├── StdioTransport (JSON-RPC)
└── 58 Tools in 14 Categories
    Build · Test · Simulator · Screenshot · UI Automation
    Logs · Console · Visual Regression · Multi-Device
    Accessibility · Localization · Automation · Git · Session

没有 Node.js。没有 Python。没有 Appium 服务。没有 Selenium。只有一个二进制文件。

要求

• macOS 13+
• Xcode 15+（用于 xcresulttool 和 simctl）
• Swift 6.0+（用于从源代码构建）
• 模拟器上已安装 WebDriverAgent（用于 UI 自动化工具）

许可证

核心二进制文件和全部 49 个免费工具均采用 MIT 许可证 — 请参阅 LICENSE。无论用于商业用途还是其他用途，都可以随意使用。

Pro 工具（额外的 9 个工具 + 更快的内部实现）需要付费许可证。许可证验证代码（LicenseManager.swift）已包含在源代码中，以确保透明；你可以查看它具体会在何时检查哪些内容。

贡献

欢迎提交问题和拉取请求。请参阅 CONTRIBUTING.md 了解指南。

隐私

SilbercueSwift 完全在你的 Mac 上运行，不会收集任何用户数据。详情请参阅 PRIVACY.md。

---

也要自动化浏览器吗？Public Browser 为 Chrome 提供了同样的方案。