drio
Open app

mcp-idb

Source

MCP server for fb-idb bridge.

Catalog onlyCatalog onlySTDIO

Overview

MCP-IDB is a server integration package that connects the Model Context Protocol (MCP) with Facebook's iOS Development Bridge (idb), enabling automated management and testing of iOS devices.

To use mcp-idb, start the server with the command: npx -y @noahlozevski/mcp-idb. Ensure that you have the idb installed and configured in your mcp-config.json file.

  • Integration with Facebook's iOS Development Bridge (idb) for automated device management. - Support for automated test execution and interactions on iOS devices. - Configuration flexibility through mcp-config.json.
  1. Automated test development for iOS applications.
  2. Performing screenshot testing on iOS devices.
  3. Automating interactions such as tapping buttons on the device screen.
  4. Installing and removing applications on iOS devices.

Add to your AI client

Use these steps to connect mcp-idb in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-idb-noahlozevski": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-idb-noahlozevski"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-idb-noahlozevski": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-idb-noahlozevski"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-idb-noahlozevski": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-idb-noahlozevski"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-idb-noahlozevski": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-idb-noahlozevski"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-idb-noahlozevski": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-idb-noahlozevski"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-idb-noahlozevski": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-idb-noahlozevski"
      ]
    }
  }
}

FAQ

**What is required to use mcp-idb?**

You need to have the idb (iOS Development Bridge) installed and configured properly.

**How do I troubleshoot common issues?**

Common issues include ensuring the idb companion is installed and that the iOS device is connected and trusted.

**Can I contribute to mcp-idb?**

Yes! Please follow the standard MCP contribution guidelines.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2189,"uuid":"9abdb01b-e56c-40a7-8e47-c4884bf162b6","name":"mcp-idb","title":"mcp-idb","description":"MCP server for fb-idb bridge.","avatar_url":"https://avatars.githubusercontent.com/u/55212226?v=4","created_at":"2025-03-09T04:00:00.584Z","updated_at":"2025-03-12T10:19:31.498Z","status":"created","author_name":"noahlozevski","author_avatar_url":"https://avatars.githubusercontent.com/u/55212226?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/noahlozevski/mcp-idb","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"MIT license\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-07 14:05:20\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools