Skip to content
Back to search

iphone-mcp

A Model Context Protocol (MCP) server for automating iPhone tasks with Appium. Supports app control, UI interactions, and screenshot capture via streamable HTTP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lakr233--iphone-mcp/badge.svg)](/listings/lakr233--iphone-mcp)

HTML

<a href="/listings/lakr233--iphone-mcp"><img src="/api/listings/lakr233--iphone-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Python 3.8 or later - Node.js and npm - iPhone with UDID - Xcode

Steps

1. Clone the repo: `git clone https://github.com/Lakr233/iphone-mcp.git && cd iphone-mcp` 2. Set up virtual environment: `python -m venv .venv && source .venv/bin/activate` 3. Install dependencies: `pip install -r requirements.txt` 4. Install Appium: `npm install -g appium && appium driver install xcuitest` 5. Set up WebDriver Agent: Follow the [WebDriver Agent Guide](https://appium.github.io/appium-xcuitest-driver/latest/guides/run-prebuilt-wda/) 6. Configure: Edit `start.sh` with your `DEVICE_UDID`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 71 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # iPhone MCP Server
  2. A Model Context Protocol (MCP) server for automating iPhone tasks with Appium. Supports app control, UI interactions, and screenshot capture via streamable HTTP.
  3. ![Screenshot on Cherry Studio](./res/screenshot.png)
  4. We recommend [Cherry Studio](https://github.com/CherryHQ/cherry-studio) as an MCP client for iPhone automation.
  5. ## Features
  6. - Retrieve device info and list installed apps
  7. - Capture screenshots (JPEG, around 500KB)
  8. - List UI elements and perform touch operations
  9. - Launch or switch apps using bundle IDs
  10. - Optimized XML output to minimize token usage
  11. ## Installation
  12. ### Prerequisites
  13. - Python 3.8 or later
  14. - Node.js and npm
  15. - iPhone with UDID
  16. - Xcode
  17. ### Steps
  18. 1. Clone the repo: `git clone https://github.com/Lakr233/iphone-mcp.git && cd iphone-mcp`
  19. 2. Set up virtual environment: `python -m venv .venv && source .venv/bin/activate`
  20. 3. Install dependencies: `pip install -r requirements.txt`
  21. 4. Install Appium: `npm install -g appium && appium driver install xcuitest`
  22. 5. Set up WebDriver Agent: Follow the [WebDriver Agent Guide](https://appium.github.io/appium-xcuitest-driver/latest/guides/run-prebuilt-wda/)
  23. 6. Configure: Edit `start.sh` with your `DEVICE_UDID`
  24. ## Usage
  25. Run `./start.sh` to start Appium and the MCP server. Access it at `http://127.0.0.1:8765/mcp` with default settings.
  26. ## Tools
  27. - `iphone_device_info`: Get device details
  28. - `iphone_device_apps`: List installed apps
  29. - `iphone_interface_snapshot`: Capture screenshot and XML
  30. - `iphone_interface_elements`: List UI elements
  31. - `iphone_operate_click`: Perform tap
  32. - `iphone_operate_swipe`: Perform swipe
  33. - `iphone_operate_text_input`: Input text
  34. - `iphone_operate_app_launch`: Launch app
  35. - `iphone_operate_get_current_bundle_id`: Get current bundle ID
  36. ## Configuration
  37. Set environment variables in `start.sh` (defaults in `src/utils.py`):
  38. - `DEVICE_UDID` (required)
  39. - `APPIUM_HOST/PORT`
  40. - `SERVER_HOST/PORT/PATH`
  41. - `LOG_LEVEL`
  42. ## Development
  43. - Run tests: `pytest`
  44. - Code style: Python 3.8+ with type hints
  45. ## Contributing
  46. Fork the repo, create a branch, and submit a pull request. Report bugs or suggest features via issues.
  47. ## License
  48. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.