mcpField
S
simctl-mcp

simctl-mcp

本地服务
github.com/ambar开发工具2062 周前更新
代码仓库

关于 simctl-mcp

simctl-mcp 是一个用于控制 iOS Simulator 的 MCP 服务，通过 npx 启动，可在 STDIO 或 HTTP 模式下运行。它面向需要在模拟器中执行设备、应用和系统操作的开发者。

主要功能

  1. 01设备创建、启动、关闭与删除
  2. 02应用安装、启动、终止与信息查询
  3. 03应用权限授予、撤销与重置
  4. 04打开 URL、切换外观与设置环境变量
  5. 05截图与剪贴板内容读写

适用场景

  1. 01在 Cursor 或 VS Code 中通过自然语言管理模拟器
  2. 02自动化安装应用并授予所需权限
  3. 03获取应用 Bundle ID 或生成 Appium 连接字符串

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 iOS Simulator 的控制工具，例如设备管理、应用管理和截图等。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "simctl": {
      "command": "npx",
      "args": [
        "-y",
        "simctl-mcp"
      ]
    }
  }
}
启动命令npx -y simctl-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmsimctl-mcp

工具

29

收录的工具列表 · 更新于 3 周前

参数类型必填说明
namestring是设备名称
runtimestring是运行时版本
deviceTypestring是设备类型

详细介绍

simctl-mcp

用于控制 iOS Simulator 的 Model Context Protocol 服务实现。

Trust Score Install MCP Server

配置

.cursor/mcp.json 或 .vscode/mcp.json：

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

提示词

提示词示例：

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

用法

此服务可通过两种模式启动：

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

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

npx simctl-mcp
HTTP 服务模式

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

# Start with default port (8081)
npx simctl-mcp --http

# Start with custom port using --port flag
npx simctl-mcp --http --port 3000

# Start with custom port using environment variable
PORT=3000 npx simctl-mcp --http

工具

设备管理：

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

应用管理：

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

应用权限：

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

系统功能：

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

证书与安全：

  • 添加根证书
  • 添加常规证书
  • 重置钥匙串

媒体与内容：

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。