askui/idb-mcp

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

11 stars 3 forks 품질 77 트렌드 26MIT

An open-source MCP server and Python library that wraps Facebook IDB to control iOS simulators for automation. Built by AskUI.

개요

An open-source MCP server and Python library that wraps Facebook IDB to control iOS simulators for automation. Built by AskUI. This project is based on the Facebook IDB CLI (fb-idb). See the GitHub repository (facebook/idb) and the Python package (fb-idb on PyPI). - : Exposes a set of iOS automation tools (list/select device, screenshot, tap, swipe, type, etc.) over MCP transports (HTTP, SSE or stdio) using fastmcp. - : Import to manage and control iOS simulators programmatically. - 🔧: list devices, select by UDID or name, boot/shutdown, kill IDB. - 👆: tap, swipe, type text, tap keys, tap buttons. - 🖼️: capture screenshots, query screen size, get view description. - 📐: optional scaling to a target viewport for consistent coordinates. ⚠️ Only iOS simulators are supported for UI control. Due to iOS security constraints, idb cannot interact with or automate the UI on real, physical devices. AskUI offers a solution for real-device UI automation—contact support@askui.

README

원문 README의 일부입니다. 원문 보기.

IDB-MCP

An open-source MCP server and Python library that wraps Facebook IDB to control iOS simulators for automation. Built by AskUI.

This project is based on the Facebook IDB CLI (fb-idb). See the GitHub repository (facebook/idb) and the Python package (fb-idb on PyPI).

What it is

MCP server: Exposes a set of iOS automation tools (list/select device, screenshot, tap, swipe, type, etc.) over MCP transports (HTTP, SSE or stdio) using fastmcp.
Python module: Import to manage and control iOS simulators programmatically.

IDB-MCP

Key features

Device management 🔧: list devices, select by UDID or name, boot/shutdown, kill IDB.
Input control 👆: tap, swipe, type text, tap keys, tap buttons.
Screen utilities 🖼️: capture screenshots, query screen size, get view description.
Image/coord scaling 📐: optional scaling to a target viewport for consistent coordinates.

Limitations

⚠️ Only iOS simulators are supported for UI control. Due to iOS security constraints, idb cannot interact with or automate the UI on real, physical devices. AskUI offers a solution for real-device UI automation—contact [email protected] for more information.

Requirements

Runs on macOS only.
Python >= 3.10
Xcode with iOS Simulators installed and configured.
- Verify simulators are visible:
```
xcrun xctrace list devices
```

Facebook IDB companion (using brew):

brew tap facebook/fb
brew install idb-companion

Install

pip install idb-mcp

Quick start (CLI)

Why MCP?

Using MCP lets your favorite AI tools connect to idb-mcp seamlessly. The client handles launching and communicating with the server, so you can ask for screenshots, taps, swipes, and more—without leaving your workflow. ✨

Start MCP server

The package installs an idb-mcp command.

# Start MCP server over HTTP (default host/port managed by fastmcp)
idb-mcp start http

GitHub에서 전체 README 보기

설치

uvx idb-mcp@latest start stdio --target-screen-size 1280 800

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "askui-idb-mcp": {
      "command": "uvx",
      "args": [
        "idb-mcp@latest",
        "start",
        "stdio",
        "--target-screen-size",
        "1280",
        "800"
      ]
    }
  }
}