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:
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.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Integration between Model Context Protocol (MCP) and Facebook's iOS Development Bridge (idb), enabling automated iOS device management and test execution through natural language.
Related Resources
Related MCP Servers
- -securityFlicense-qualityFacilitates interaction and context sharing between AI models using the standardized Model Context Protocol (MCP) with features like interoperability, scalability, security, and flexibility across diverse AI systems.Last updated -1Python
- -securityFlicense-qualityImplements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.Last updated -125Python
- -securityAlicense-qualityA Model Context Protocol (MCP) implementation for connecting to and working with various database systems.Last updated -1718TypeScriptMIT License
- -securityAlicense-qualityAn implementation of the Model Context Protocol (MCP) that enables interaction with debug adapters, allowing language models to control debuggers, set breakpoints, evaluate expressions, and navigate source code during debugging sessions.Last updated -14PythonAGPL 3.0