使用说明

项目简介

本项目是一个基于Model Context Protocol (MCP) 的服务器实现，它充当大型语言模型（LLM）与iOS模拟器之间的桥梁，使得用户可以通过自然语言指令来控制和操作iOS模拟器。

主要功能点

模拟器控制：创建和管理模拟器会话，启动、关闭和监控模拟器状态，列出可用的模拟器等。
应用管理：安装、启动、终止和卸载iOS应用程序，监控应用状态，处理应用权限等。
UI交互与测试：通过自然语言指令模拟用户界面交互，如点击、滑动、输入文本，并支持访问辅助功能元素进行UI测试。
开发与调试：捕获屏幕截图和系统日志，实时调试应用程序，监控和分析崩溃日志。
高级功能：支持位置模拟、媒体注入、URL Scheme处理、联系人数据库管理和Keychain操作等。

安装步骤

您可以通过以下两种方式安装此服务器：

方式一：使用Cline (推荐)

在Cline中运行以下命令，Cline将自动处理安装过程，包括依赖管理和配置：

Add this mcp to cline https://github.com/InditexTech/mcp-server-simulator-ios-idb

方式二：手动安装

克隆仓库到本地：

git clone https://github.com/InditexTech/mcp-server-simulator-ios-idb.git
cd mcp-server-simulator-ios-idb

创建并激活Python虚拟环境：

python3 -m venv venv
source venv/bin/activate  # 在Unix/macOS系统

安装依赖：
```
npm install
```
构建项目：
```
npm run build
```
启动服务器：
```
npm start
```
注意：手动安装时，请确保在使用服务器时保持虚拟环境处于激活状态。

服务器配置

要将此MCP服务器与MCP客户端（如Claude Desktop）集成，您需要配置服务器连接信息。以下是一个示例配置，您需要根据实际情况修改路径：

{
  "mcpServers": {
    "ios-simulator": {
      "command": "node",
      "args": ["/path/to/mcp-server-simulator-ios-idb/dist/index.js"],
      "env": {}
    }
  }
}

配置参数说明:

'server name': 服务器名称，例如 '"ios-simulator"'，客户端使用此名称来识别和调用服务器。
'command': 启动服务器的命令，这里是 'node'，表示使用Node.js运行JavaScript文件。
'args': 启动命令的参数列表，这里指定了服务器入口文件 'dist/index.js' 的路径。请将 '/path/to/mcp-server-simulator-ios-idb' 替换为实际的仓库克隆路径。
'env': 环境变量，默认为空对象 '{}'。

基本使用方法

配置完成后，您可以使用自然语言指令通过MCP客户端与iOS模拟器服务器进行交互。以下是一些示例指令：

create a simulator session with iPhone 14  // 创建一个iPhone 14模拟器会话
install app /path/to/my-app.ipa          // 安装应用
launch app com.example.myapp             // 启动应用
tap at 100, 200                         // 点击屏幕坐标 (100, 200)
take a screenshot                        // 截取屏幕截图

请参考仓库文档 'README.md' 获取更详细的命令列表和使用说明。

关键词