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
• 添加媒體文件
• 獲取/設置環境變量
• 獲取/設置外觀（輕量級/深色模式）
• 發送模擬推送通知

證書與安全

• 添加根證書
• 添加普通證書
• 重置密鑰鏈