simctl-mcp

用于 iOS 模拟器控制的模型上下文协议服务器实现。

配置

.cursor/mcp.json 或 .vscode/mcp.json:

{
  "mcpServers": {
    "simctl-mcp": {
      "command": "npx",
      "args": ["-y", "simctl-mcp"]
    }
  }
}

提示语

一些提示语示例：

• 模拟器支持哪些操作？
• 打开 shortcuts://
• “设置”应用的 Bundle ID 是什么？
• 设置剪贴板内容为：Hello
• 模拟器 SDK 版本是什么？
• 为“设置”应用生成 Appium 连接字符串

用法

服务器可以在两种模式下启动：

1. STDIO 模式（默认）
2. HTTP 服务器模式

STDIO 模式

在 STDIO 模式下，服务器通过标准输入/输出流进行通信。

npx simctl-mcp

HTTP 服务器模式

在 HTTP 服务器模式下，服务器监听指定端口上的 HTTP 连接。

# 使用默认端口 (8081) 启动
npx simctl-mcp --http

# 使用 --port 标志使用自定义端口启动
npx simctl-mcp --http --port 3000

# 使用环境变量使用自定义端口启动
PORT=3000 npx simctl-mcp --http

工具

设备管理：

• 创建新的模拟器设备
• 删除现有设备
• 启动设备
• 关闭设备
• 列出所有可用设备
• 列出可用设备类型
• 列出可用运行时

应用管理：

• 安装应用
• 卸载应用
• 启动应用
• 终止正在运行的应用
• 获取应用容器路径
• 获取应用信息
• 列出已安装的应用

应用权限：

• 授予应用权限
• 撤销应用权限
• 重置所有应用权限

系统功能：

• 在模拟器中打开 URL
• 添加媒体文件
• 获取/设置环境变量
• 获取/设置外观（浅色/深色模式）
• 发送模拟推送通知

证书与安全：

• 添加根证书
• 添加普通证书
• 重置钥匙串

媒体与内容：

• 截取屏幕截图
• 获取/设置粘贴板内容（剪贴板）