The MCP-IDB server enables automated iOS device management and testing using Facebook's IDB (iOS Development Bridge).
Capabilities include:
Execute arbitrary IDB commands for device control
Perform automated UI interactions (tapping, swiping, pressing hardware buttons like Apple Pay, Home, Lock, Side Button, Siri)
Input text and send key events
Obtain UI element layout information to calculate precise interaction points
Capture screenshots for testing
Install and remove applications on connected devices or simulators
Run automated tests
Integrates with Facebook's iOS Development Bridge (idb), enabling iOS device management and test execution for mobile apps.
Uses Homebrew for installing the idb-companion, which is required for the iOS device management functionality.
Enables automated iOS device management, including app installation, test execution, UI interaction (taps, swipes, button presses), and screenshot capture.
mcp-idb
MCP server integration for Facebook's iOS Development Bridge (idb).
Overview
This package provides integration between MCP (Model Context Protocol) and Facebook's idb (iOS Development Bridge), enabling automated iOS device management and test execution through MCP.
Start the server:
Related MCP server: MCP Agents Server
Prerequisites
Installing idb
To install idb:
For more details, visit the official idb GitHub repository.
Configuration
mcp-config.json Setup
To use idb in your MCP configuration, add the following to your mcp-config.json:
Example use cases include:
Automated test development
Screenshot testing
Automated interactions ("tap the home button on the screen")
Installing / removing applications
Development
Code Formatting
This project uses Prettier for code formatting. To format your code:
The formatting configuration can be found in .prettierrc at the root of the project.
Troubleshooting
Common issues and solutions:
idb companion not found: Ensure idb-companion is installed via Homebrew
Device not detected: Make sure the iOS device is:
Connected via USB
Trusted on the computer
Has developer mode enabled
Contributing
Please follow the standard MCP contribution guidelines when making changes to this package.
License
This project is part of Mobile Control Plane (MCP) and follows Amazon's internal licensing policies.