AI导哈

Xcode模拟器集成工具

一个统一的MCP服务器，用于构建、部署、截图并与iOS应用程序交互，支持从Claude Code、Codex、Cursor或任何MCP客户端操作。

  • by kevinswint
  • Swift
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 kevinswint/xcode-studio-mcp

使用说明

xcode工作室mcp

Xcode+iOS模拟器的统一MCP服务器 --从构建、部署、截图和与iOS应用程序交互 克劳德代码, 法典, 光标或任何MCP客户端。

内置Swift。单二进制。不需要Node/Python运行时。

为什么存在

今天，你需要2-3个单独的工具来使用AI代理完成完整的iOS开发循环。 xcode工作室mcp 将它们组合成一个：

Write code → Build → Deploy to Simulator → Screenshot → Tap/Type → Verify

工具

工具 说明
xcode_build 构建一个带有结构化错误输出（文件、行、列、严重性、消息）的Xcode项目
xcode_run 在iOS模拟器中构建并启动应用程序
simulator_screenshot 将模拟器屏幕捕获为PNG图像
simulator_tap 在模拟器屏幕上点击x、y坐标
simulator_type 在当前关注的字段中键入文本
simulator_describe 获取当前屏幕的可访问性树（JSON）

刀具参数

xcode_build

参数 必填 说明
project_path Yes Xcode项目目录路径， .xcodeproj，或 .xcworkspace
scheme 否 构建方案（如果省略，则自动检测）
configuration 没有 Debug （默认）或 Release
destination 否 构建目标（默认为已启动的模拟器）

xcode_run

参数 必填 说明
project_path 是 Xcode项目的路径
bundle_identifier 是 应用包ID（例如。 com.example.MyApp)
scheme 否 构建方案（自动检测）
simulator_udid 否 目标模拟器（默认启动）

simulator_screenshot

参数 必填 说明
simulator_udid 否 目标模拟器（默认启动）

simulator_tap

参数 必填 说明
x 是 X坐标
y 是 Y坐标
duration 否 保持时间（秒）（长按）
simulator_udid 否 目标模拟器

simulator_type

参数 必填 说明
text 是 要键入的文本
simulator_udid 否 目标模拟器

simulator_describe

参数 必填 说明
simulator_udid 否 目标模拟器

快速开始

先决条件

  • 安装了Xcode的macOS
  • 用于UI交互工具(tap, type, describe):
    brew tap facebook/fb && brew install idb-companion
pip3 install fb-idb

构建

git clone https://github.com/kevinswint/xcode-studio-mcp.git
cd xcode-studio-mcp
swift build -c release

配置Claude代码

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "xcode-studio-mcp": {
      "command": "/path/to/xcode-studio-mcp/.build/release/XcodeStudioMCP"
    }
  }
}

示例工作流程

You: Build and run my app at ~/Projects/MyApp
Claude: [calls xcode_build] Build succeeded with 0 errors
        [calls xcode_run] App launched (PID 12345)
        [calls simulator_screenshot] Here's what the app looks like...
        [calls simulator_describe] I can see a "Sign In" button and email/password fields
        [calls simulator_tap] Tapped the email field
        [calls simulator_type] Typed "test@example.com"
        [calls simulator_screenshot] Here's the current state...

建筑

┌─────────────────────────────┐
│     MCP Protocol Layer      │  stdio transport (Swift MCP SDK)
├─────────────────────────────┤
│   Tool Implementations      │  6 tools, structured error output
├──────────┬──────────────────┤
│ xcodebuild│  simctl  │  idb │  native process calls
│  wrapper  │  wrapper │ CLI  │
└──────────┴──────────┴──────┘

内置Swift，无Node/Python运行时依赖关系（仅UI交互工具需要idb CLI）。

路线图

  • v0.1 （当前）：核心构建+模拟器工具
  • v1.0：语义UI导航（“点击登录按钮”）、视觉差异、Xcode项目文件操作、复合操作、SwiftUI预览捕获

相关项目

项目 它做什么 区别
XcodeBuildMCP 仅构建+测试 无模拟器UI交互
移动mcp 跨平台模拟器UI 不支持Xcode构建
ios模拟器mcp 通过IDB进行模拟器 无需构建，一切都依赖于IDB

xcode工作室mcp 组合构建 和 与单个服务器交互。

贡献

PR欢迎。代码库是大约750行Swift代码，分为工具、服务和模型。

许可证

麻省理工学院

相关 MCP