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

• idb (iOS Development Bridge)

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:

1. idb companion not found: Ensure idb-companion is installed via Homebrew
2. 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.