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

To install idb:

brew tap facebook/fb
brew install idb-companion

# verify installation
idb

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:

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.

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

Please follow the standard MCP contribution guidelines when making changes to this package.

This project is part of Mobile Control Plane (MCP) and follows Amazon's internal licensing policies.