iOS simulators MCP

📱 iOS模拟器的MCP服务器

一种模型上下文协议（MCP）服务器，使LLM能够通过自然语言命令与iOS模拟器进行交互。

ℹ️ 概述

此MCP服务器在大型语言模型（LLM）和iOS模拟器之间提供了一座桥梁，通过自然语言命令提供全面的控制。以下是它可以做的事情：

有关详细用法，请参阅安装指南和支持的命令部分。您可以通过直接MCP集成或作为独立库使用此服务器。

查看架构部分，了解组件如何协同工作，以实现iOS模拟器的自然语言控制。

🎮 模拟器控制

• 创建和管理模拟器会话
• 启动、关闭和监控模拟器状态
• 列出可用和正在运行的模拟器
• 聚焦模拟器窗口

📱 应用程序管理

• 安装和管理iOS应用程序
• 启动、终止和卸载应用程序
• 监控应用程序状态并验证安装
• 处理应用程序权限和配置

🖱️ UI交互和测试

• 与模拟器UI交互
• 执行点击、滑动和按钮按压操作
• 输入文本和按键序列
• 访问UI测试的可访问性元素
• 录制用户界面交互视频

🛠️ 开发与调试

• 捕获屏幕截图和系统日志
• 实时调试应用程序
• 监控和分析碰撞日志
• 安装动态库并管理应用程序数据

⚡ 高级功能

• 其他功能包括：

- 位置模拟 - 介质注入 - URL方案处理 - 联系人数据库管理 - 钥匙扣操作

有关详细用法，请参阅安装指南和支持的命令部分。您可以通过直接MCP集成或作为独立库使用此服务器。

查看架构部分，了解组件如何协同工作，以实现iOS模拟器的自然语言控制。

📋 需求

• macOS：需要iOS模拟器支持
• Node.js：v14.0.0或更高版本
• 家酿：安装依赖项时需要
• 介绍：安装了iOS模拟器

🚀 安装

安装此服务器的最简单方法是通过Cline：

1. 只需询问Cline：

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

1. Cline将自动处理安装过程，包括依赖关系管理和配置。

或者，您可以手动安装它：

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

# Create and activate Python virtual environment
python3 -m venv venv
source venv/bin/activate  # On Unix/macOS

# Install dependencies
npm install

# Build the project
npm run build

# Start the project
npm start

# Run tests
npm test

安装过程将自动执行以下操作：

1. 检查您是否运行macOS
2. 通过Homebrew安装idb伴侣
3. 在虚拟环境中通过pip安装fb-idb

注意：使用服务器时，请确保虚拟环境保持激活状态。如果您关闭终端并稍后返回，则需要使用重新激活虚拟环境 source venv/bin/activate 运行前的命令 npm start.

🔌 MCP集成

要将此服务器与Claude或其他LLM助手一起使用：

1. 将服务器添加到Claude Desktop中的MCP设置中：

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

1. LLM现在可以使用自然语言命令来控制iOS模拟器：

create a simulator session with iPhone 14
install app /path/to/my-app.ipa
launch app com.example.myapp
tap at 100, 200
take a screenshot

📚 作为图书馆使用

您还可以在自己的项目中将此包用作库：

🔰 基本用法

import { createMCPServer } from 'mcp-server-simulator-ios-idb';

async function main() {
  // Create an instance of the MCP server
  const { orchestrator } = createMCPServer();
  
  // Process natural language commands
  
  // Create a simulator session
  const sessionResult = await orchestrator.processInstruction('create session');
  console.log(`Session created: ${sessionResult.data}`);
  
  // Interact with the simulator
  await orchestrator.processInstruction('tap at 100, 200');
  
  // Capture a screenshot
  const screenshotResult = await orchestrator.processInstruction('take screenshot');
  console.log(`Screenshot saved at: ${screenshotResult.data}`);
}

main().catch(console.error);

🚀 高级用法

您还可以直接使用各个组件：

import { 
  IDBManager, 
  NLParser, 
  MCPOrchestrator,
  ParserToOrchestrator,
  OrchestratorToIDB
} from 'mcp-server-simulator-ios-idb';

// Create instances
const idbManager = new IDBManager();
const parser = new NLParser();
const orchestrator = new MCPOrchestrator(parser, idbManager);

// Use the components directly
const sessionId = await idbManager.createSimulatorSession({
  deviceName: 'iPhone 12',
  platformVersion: '15.0'
});

await idbManager.tap(sessionId, 100, 200);

🏗️ 项目结构

mcp-server-simulator-ios-idb/
├── src/                      # Source code
│   ├── adapters/             # Adapter components
│   ├── idb/                  # IDB manager implementation
│   ├── mcp/                  # MCP server implementation
│   ├── orchestrator/         # Command orchestrator
│   ├── parser/              # Natural language parser
│   └── index.ts             # Main entry point
├── types/                   # TypeScript type definitions
├── scripts/                 # Installation scripts
├── package.json            # Project configuration
└── tsconfig.json          # TypeScript configuration

🎯 支持的命令

NLParser支持以下自然语言命令：

🎮 模拟器管理

📱 应用程序管理

🖱️ UI交互

♿ 无障碍

📸 捕获和日志

🐛 调试

💥 崩溃日志

🔧 附加命令

该界面支持idb CLI工具中可用的所有命令，为iOS模拟器自动化提供了一套全面的操作。

🔍 建筑

服务器由三个主要组件组成：

1. IDB经理：通过idb直接与iOS模拟器交互的低级组件。
2. NLParser：解释自然语言指令并将其转换为结构化命令的组件。
3. MCP编排器：协调解析器和IDBManager之间交互的中心组件。

这些组件通过适配器连接：

• ParserToCorchestrator：将解析器结果转换为编排器命令。
• 编排器ToIDB：将编排器命令转换为IDBManager调用。

🔌 MCP集成

要将此服务器与模型上下文协议一起使用，请执行以下操作：

1. 将服务器添加到MCP设置中：

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

1. 连接到LLM应用程序中的服务器：

const result = await useMcpTool({
  serverName: "ios-simulator",
  toolName: "process-instruction",
  arguments: {
    instruction: "create simulator session"
  }
});

🙏 致谢

如果没有，这个项目是不可能的 脸书/idb，它提供了底层iOS模拟器控制功能。我们衷心感谢Facebook/Meta团队和idb项目的所有贡献者创建和维护了这样一个强大而可靠的工具。

📄 许可证

根据Apache-2.0的条款，此工具可作为开源工具使用。