simctl-mcp

simctl-mcp

site icon
2025.04.01 4
TypeScriptiOS 模拟器控制开发工具开发效率
simctl-mcp 是一个用于控制 iOS 模拟器的 Model Context Protocol 服务器实现。它提供了丰富的功能来管理模拟器设备、应用程序、系统特性以及媒体内容等,适用于开发人员在 iOS 应用开发过程中进行模拟器操作和调试。
View on GitHub

Overview

基本能力

产品定位

simctl-mcp 是一个专为 iOS 模拟器控制设计的工具,旨在通过 MCP 协议提供高效的模拟器操作和管理功能。

核心功能

  1. 设备管理:创建、删除、启动、关闭模拟器设备,列出可用设备类型和运行时。
  2. 应用管理:安装、卸载、启动、终止应用,获取应用信息和容器路径。
  3. 应用权限:授予、撤销应用权限,重置所有权限。
  4. 系统特性:打开 URL、添加媒体文件、管理环境变量、设置外观模式、发送模拟推送通知。
  5. 证书与安全:添加根证书和普通证书,重置钥匙链。
  6. 媒体与内容:截图、管理剪贴板内容。

适用场景

  • iOS 应用开发过程中的模拟器操作和调试。
  • 自动化测试和持续集成流程中的模拟器管理。
  • 开发人员快速验证应用功能和权限设置。

工具列表

  1. 设备管理工具:支持创建、删除、启动、关闭模拟器设备。
  2. 应用管理工具:支持安装、卸载、启动、终止应用。
  3. 权限管理工具:支持授予、撤销应用权限。
  4. 系统工具:支持管理环境变量、外观模式、推送通知等。
  5. 证书工具:支持添加证书和重置钥匙链。
  6. 媒体工具:支持截图和剪贴板管理。

常见问题解答

  • 如何启动 HTTP 服务器模式?:使用 npx simctl-mcp --http 命令。
  • 如何自定义端口?:使用 --port 参数或 PORT 环境变量。

使用教程

使用依赖

  • 需要安装 Node.js 和 npm。

安装教程

  1. 确保已安装 Node.js 和 npm。
  2. 通过 npm 安装 simctl-mcp: bash npm install -g simctl-mcp

调试方式

  1. STDIO 模式bash npx simctl-mcp
  2. HTTP 服务器模式bash npx simctl-mcp --http
  3. 自定义端口bash npx simctl-mcp --http --port 3000bash PORT=3000 npx simctl-mcp --http

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。