The MCP server for iOS simulator provides a bridge between Large Language Models (LLMs) and iOS simulators, allowing you to control iOS simulators through natural language commands. It enables simulator control, app management, UI interactions, and advanced debugging features through simple text instructions.
The easiest installation method is through Cline:
Add this mcp to cline https://github.com/InditexTech/mcp-server-simulator-ios-idb
Cline will handle the installation process automatically, including dependency management.
You can also install the server manually:
# 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
The installation process will:
Note: Keep the virtual environment activated while using the server. If you close your terminal, reactivate with source venv/bin/activate before running npm start.
To use this server with Claude or other LLM assistants:
{
"mcpServers": {
"ios-simulator": {
"command": "node",
"args": ["/path/to/mcp-server-simulator-ios-idb/dist/index.js"],
"env": {}
}
}
}
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();
// 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);
create session, create simulator iPhone 12terminate session, close simulatorlist simulators, show simulatorslist booted simulatorsboot simulator 5A321B8F-4D85-4267-9F79-2F5C91D142C2shutdown simulator 5A321B8F-4D85-4267-9F79-2F5C91D142C2focus simulator, bring simulator to frontlist simulator sessionsinstall app /path/to/app.ipalaunch app com.example.appterminate app com.example.appuninstall app com.example.applist apps, show installed appsis app com.example.app installedtap at 100, 200swipe from 100, 200 to 300, 400press button HOME, press button SIRIinput text Hello Worldpress key 4press key sequence 4 5 6describe all elements, show accessibility elementsdescribe point 100, 200, what's at 150, 300take screenshot, capture screenrecord video /path/output.mp4stop recording, stop video recordingget logs, get logs for com.example.appdebug app com.example.appstop debug, terminate debug sessiondebug status, show debug infolist crash logs, show crash logsshow crash log crash_2023-01-01delete crash logs, clear crash logsinstall dylib /path/to/library.dylibopen url https://example.comclear keychainset location 37.7749, -122.4194add media /path/to/image.jpgapprove permissions com.example.app photos cameraupdate contacts /path/to/contacts.sqliteThere are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.
To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".
When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:
{
"mcpServers": {
"cursor-rules-mcp": {
"command": "npx",
"args": [
"-y",
"cursor-rules-mcp"
]
}
}
}
To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.