simctl-mcp

🚀 仿真控制协议 (simctl-mcp)

仿真控制协议 (simctl-mcp) 是一个用于 iOS 模拟器控制的模型上下文协议服务器实现，能帮助开发者高效控制 iOS 模拟器。

🚀 快速开始

配置

需在 .cursor/mcp.json 或 .vscode/mcp.json 中进行如下配置：

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

使用方法

服务器可以以两种模式运行：

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

💡 使用提示

以下是一些使用时的提示示例：

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

🔧 工具功能

设备管理

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

应用管理

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

应用权限

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

系统功能

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

证书与安全

• 添加根证书
• 添加普通证书
• 重置密钥链