iOS Simulator

iOS Simulator

A Model Context Protocol (MCP) server that enables LLMs to interact with iOS simulators through natural language command

276
Stars
23
Forks
2
Releases

Overview

Provides a bridge between Large Language Models and iOS simulators, enabling natural language control via MCP. The server includes an NLParser to translate human language instructions into structured commands, an MCPOrchestrator that coordinates actions, and an IDBManager that directly interfaces with iOS simulators through idb. It can be used as an MCP-integrated service or as a standalone library. The system supports simulator session management (create, boot, shutdown, list, focus), app management (install, launch, terminate, uninstall, list, verify), UI interactions and testing (tap, swipe, input, describe elements, accessibility queries, video capture), and development workflows (capture logs, crash reports, real-time debugging). Advanced capabilities include location simulation, media injection, URL handling, contact database updates, and keychain operations. The server is designed to work on macOS with Node.js, and can be installed via Cline or manually. It exposes actionable commands to Claude Desktop and other LLMs through MCP, and provides TypeScript examples for library usage to embed into custom projects.

Details

Owner
InditexTech
Language
TypeScript
License
Apache License 2.0
Updated
2025-12-07

Features

Natural Language Command Parsing

NLParser interprets natural language instructions and converts them into structured commands for the orchestrator.

MCP Orchestrator Coordination

Central component coordinating between NLParser and IDBManager to execute user instructions.

Simulator Session Lifecycle Management

Create, boot, shutdown, list, and focus simulator sessions, and manage active sessions.

App Management on Simulators

Install, launch, terminate, uninstall apps; list installed apps and verify installations.

UI Interaction & Accessibility Testing

Perform taps, swipes, text input, button presses, and access accessibility elements for UI testing.

Debugging, Logs & Crashes

Capture screenshots and system logs, start/stop debugging, monitor crash logs.

Capture & Media Operations

Take screenshots, record video, and manage media-related actions during simulator sessions.

Advanced Features & Extensions

Support location simulation, media injection, URL schemes, contacts, and keychain operations.

Audience

LLM developersBuild NL-driven control tools for iOS simulators using MCP integration.
QA engineersAutomate UI testing and app lifecycle on iOS simulators with natural language commands.
MCP integratorsIntegrate MCP-enabled simulator control into LLM workflows and tooling.

Tags

MCPiOS SimulatoridbNLParserMCPOrchestratornatural language commandsUI automationApp managementTesting & debuggingMacOSClaude integrationlibrary usage