Ios Simulator MCP Server

iOS模拟器MCP服务器

MCP（模型上下文协议）服务器，为Claude Code提供对iOS模拟器的代理控制，用于UI/UX调试和开发。

特性

模拟器控制

• 列出、启动和关闭模拟器
• 截图
• 设置位置，状态栏覆盖
• 提醒推送
• 管理应用程序权限

应用管理

• 安装、启动和终止应用程序
• 列出已安装的应用程序
• 打开网址
• 访问应用程序容器

UI交互（需要IDB）

• 点击坐标
• 滑动手势
• 文本输入
• 硬件按钮按下

深度UI调试（需要ClaudeDebugKit）

• 完成视图层次结构检查
• 自动布局约束分析
• 触摸目标尺寸审核（最小44pt）
• 颜色对比度审计（WCAG AA/AAA）
• 可访问性审计
• 字体和颜色检查
• 视图突出显示
• 特性收集覆盖（暗模式、动态类型）
• 内存统计数据和性能指标

安装

先决条件

1. Xcode iOS模拟器
2. Node.js 18+
3. 国际开发银行 （可选，用于UI交互）：

   brew install idb-companion
   pip install fb-idb

安装MCP服务器

cd ios-simulator-mcp-server
npm install
npm run build

配置Claude代码

添加到您的Claude Code MCP配置中(~/.config/claude-code/mcp.json):

{
  "mcpServers": {
    "ios-simulator": {
      "command": "node",
      "args": ["/path/to/ios-simulator-mcp-server/dist/index.js"]
    }
  }
}

将ClaudeDebugKit添加到您的iOS应用程序

对于深度UI检查功能，请将Swift包添加到您的iOS项目中：

1. 在Xcode中：文件→ 添加包依赖关系
2. 输入： file:///path/to/ClaudeDebugKit
3. 添加到您的应用程序（仅限调试版本）：

#if DEBUG
import ClaudeDebugKit

// In AppDelegate or SceneDelegate
func application(_ application: UIApplication, didFinishLaunchingWithOptions...) {
    ClaudeDebugServer.shared.start()
    return true
}
#endif

使用示例

基本模拟器控制

"List all available iOS simulators"
"Boot iPhone 15 Pro"
"Take a screenshot of the simulator"
"Set the location to San Francisco (37.7749, -122.4194)"

应用程序开发工作流

"Install my app from ~/Build/MyApp.app and launch it"
"Get the view hierarchy of the current screen"
"Find all interactive elements"
"Audit touch targets for HIG compliance"

UI/UX调试

"Check color contrast for WCAG AA compliance"
"Show me the constraints on the login button"
"Highlight the view with accessibility label 'Submit'"
"Run a full UI/UX audit"

测试不同的配置

"Switch to dark mode"
"Override Dynamic Type to extra large"
"Simulate a memory warning"
"Get memory stats for the app"

可用工具

模拟器管理

应用管理

UI交互（需要IDB）

查看调试（需要ClaudeDebugKit）

审计（需要ClaudeDebugKit）

建筑

┌─────────────────────────────────────────────────────────┐
│                     Claude Code                          │
└─────────────────────┬───────────────────────────────────┘
                      │ MCP Protocol (stdio)
                      ▼
┌─────────────────────────────────────────────────────────┐
│              ios-simulator-mcp-server                    │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐ │
│  │   simctl    │  │     IDB     │  │  Debug Client   │ │
│  │  (built-in) │  │ (optional)  │  │   (HTTP)        │ │
│  └──────┬──────┘  └──────┬──────┘  └────────┬────────┘ │
└─────────┼────────────────┼──────────────────┼──────────┘
          │                │                  │
          ▼                ▼                  ▼
┌─────────────────────────────────────────────────────────┐
│                    iOS Simulator                         │
│  ┌───────────────────────────────────────────────────┐ │
│  │                   Your iOS App                     │ │
│  │  ┌─────────────────────────────────────────────┐  │ │
│  │  │            ClaudeDebugKit                    │  │ │
│  │  │         (HTTP Server on :8765)               │  │ │
│  │  └─────────────────────────────────────────────┘  │ │
│  └───────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

需求

• macOS与Xcode 15+
• Node.js 18+
• ClaudeDebugKit的iOS 14+目标

许可证

麻省理工学院