iOS Development Bridge (idb)

# mcp-idb

MCP server integration for Facebook's iOS Development Bridge (idb).

## Overview

This package provides integration between [MCP (Model Context Protocol)](https://modelcontextprotocol.io/introduction) and Facebook's [idb (iOS Development Bridge)](https://fbidb.io/docs/installation/), enabling automated iOS device management and test execution through MCP.

Start the server:
```sh
npx -y @noahlozevski/mcp-idb
```

## Prerequisites

- [idb (iOS Development Bridge)](https://fbidb.io/docs/installation/)

### Installing idb

To install idb:

```bash
brew tap facebook/fb
brew install idb-companion

# verify installation
idb
```

For more details, visit the [official idb GitHub repository](https://github.com/facebook/idb).

## Configuration

### mcp-config.json Setup

To use idb in your MCP configuration, add the following to your `mcp-config.json`:

```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:

```bash
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.