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:
npx -y @noahlozevski/mcp-idb
Prerequisites
Installing idb
To install idb:
brew tap facebook/fb
brew install idb-companion
# verify installation
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:
{
"mcpServers": {
"idb": {
"command": "npx",
"args": ["-y", "@noahlozevski/idb"]
}
}
}
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:
npm run format # Format all files
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.