simctl-mcp

用于iOS模拟器控制的Model Context Protocol服务器实现。

配置

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

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

提示词示例

一些提示词示例：

• 模拟器支持哪些操作？
• 打开shortcuts://
• “设置”应用的包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
• 添加媒体文件
• 获取/设置环境变量
• 获取/设置外观（浅色/深色模式）
• 发送模拟推送通知

证书与安全：

• 添加根证书
• 添加常规证书
• 重置密钥链

媒体与内容：

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