Ios Simulator Automation (IDB)

🚀 MCP Server - iOS Simulator Control Tool

MCP Server is an automated control service for iOS simulators based on the idb tool. It leverages natural language processing technology to convert user-provided instructions into executable operation commands, enabling comprehensive control of iOS simulators.

🚀 Quick Start

📦 Installation

Install Dependencies

Before you start, make sure you have installed the following tools:

• Node.js (Recommended version 14 or higher)
• idb command-line tool

Clone the Repository

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

Install Dependencies

Run the following command to install the npm packages required for the project:

npm install

Start the Server

Use Node.js to execute the main program file and start the server:

node index.js

✨ Features

The server offers a wide range of iOS simulator control functions, covering the following aspects:

Basic Operations

1. Simulator Session Management

   • Create, activate, and terminate simulator sessions
   • List all available iOS simulators

2. App Lifecycle

   • Start, stop, and restart applications
   • View running applications
   • Analyze application performance data

3. File System Operations

   • Upload and download files to the simulator
   • Create, delete, and traverse directories
   • Copy and move files

4. Process Management

   • List all running processes
   • Start and stop specific processes
   • View detailed process information

Advanced Features

1. Debugging and Logging

2. Graphical Interface Operations

   • Capture screenshots
   • Record screen videos
   • Simulate touch events

3. Permission Management

   • Request and grant application permissions
   • Manage keychain access
   • Monitor network traffic

4. Simulation Environment

💻 Usage Examples

# Create a new simulator session
curl -X POST http://localhost:3000/api/simulator/session

# Start an app
curl -X POST http://localhost:3000/api/app/start \
     -d '{"bundleId":"com.example.app"}'

# Capture a screenshot
curl -X GET http://localhost:3000/api/capture/screenshot

🔧 Technical Details

Core Components

1. IDBManager

   • Responsible for low-level communication with iOS simulators
   • Executes all command operations of the idb tool
   • Manages the lifecycle and session state of simulators

2. NLParser

   • Receives and parses natural language instructions provided by users
   • Converts them into structured command requests
   • Supports complex multi-step operations

3. MCPOrchestrator

   • Coordinates the interaction between various components
   • Distributes commands to the corresponding execution modules
   • Handles asynchronous operations and error handling

Adapters and Plugins

• idb CLI Adapter: Supports all functions of the idb command-line tool
• HTTP Adapter: Provides a RESTful API interface
• WebSocket Plugin: Enables real-time communication capabilities

📚 Documentation

Quick Start

1. Install and start the server
2. Configure the client SDK
3. Send commands for testing

Example Configuration

const mcp = new MCPClient('ws://localhost:3001');

async function launchApp() {
    try {
        await mcp.sendCommand({
            type: 'app_launch',
            payload: { bundleId: 'com.example.app' }
        });
        console.log('App has been launched');
    } catch (error) {
        console.error('Launch failed:', error);
    }
}

🤝 Contributing

How to Contribute

1. Submit issue reports
2. Create feature requests
3. Participate in code reviews
4. Contribute code modifications

Contributors

Thanks to all developers and users who have contributed to this project.

📄 License

This project is licensed under the MIT License. The full text of the license is as follows:

MIT License

Copyright (c) [Year] [Author's Name]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

📞 Contact

Project Maintainer

• Developer: [Your Name]
  Email: your.email@example.com

Issue Feedback

You are welcome to submit issues or pull requests on GitHub to help us improve this project.