1. Conduid
  2. AI
  3. Iphone MCP
MCP server · AI

Iphone MCP

by · github.com/Lakr233/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.

Unclaimed MIT last commit a year ago ai
InstallView source
67Good

Scored 7 days ago · breakdown

About Iphone MCP

Iphone MCP is an MCP server published by Lakr233 in the AI category: a Model Context Protocol (MCP) server for automating iPhone tasks with Appium. Supports app control, UI interactions, and screenshot capture via streamable HTTP.

The repository has 137 stars and 12 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/Lakr233/iphone-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (9)

iphone_device_appsList installed apps

Parameters not published.

iphone_device_infoGet device details

Parameters not published.

iphone_interface_elementsList UI elements

Parameters not published.

iphone_interface_snapshotCapture screenshot and XML

Parameters not published.

iphone_operate_app_launchLaunch app

Parameters not published.

iphone_operate_clickPerform tap

Parameters not published.

iphone_operate_get_current_bundle_idGet current bundle ID

Parameters not published.

iphone_operate_swipePerform swipe

Parameters not published.

iphone_operate_text_inputInput text

Parameters not published.

Ask AI

✦

Ask AI about Iphone MCP

Powered by Claude · Grounded in docs

I know everything about Iphone MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 23 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • !Dependencies pinnedNo lockfile. Installs can pull different code over time.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

iPhone MCP Server

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

Screenshot on Cherry Studio

We recommend Cherry Studio as an MCP client for iPhone automation.

Features

  • Retrieve device info and list installed apps
  • Capture screenshots (JPEG, around 500KB)
  • List UI elements and perform touch operations
  • Launch or switch apps using bundle IDs
  • Optimized XML output to minimize token usage

Installation

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
  6. Configure: Edit start.sh with your DEVICE_UDID

Usage

Run ./start.sh to start Appium and the MCP server. Access it at http://127.0.0.1:8765/mcp with default settings.

Tools

  • iphone_device_info: Get device details
  • iphone_device_apps: List installed apps
  • iphone_interface_snapshot: Capture screenshot and XML
  • iphone_interface_elements: List UI elements
  • iphone_operate_click: Perform tap
  • iphone_operate_swipe: Perform swipe
  • iphone_operate_text_input: Input text
  • iphone_operate_app_launch: Launch app
  • iphone_operate_get_current_bundle_id: Get current bundle ID

Configuration

Set environment variables in start.sh (defaults in src/utils.py):

  • DEVICE_UDID (required)
  • APPIUM_HOST/PORT
  • SERVER_HOST/PORT/PATH
  • LOG_LEVEL

Development

  • Run tests: pytest
  • Code style: Python 3.8+ with type hints

Contributing

Fork the repo, create a branch, and submit a pull request. Report bugs or suggest features via issues.

License

MIT

README fetched from the repository 23 hours ago. The original is authoritative.

Questions

About Iphone MCP

How do I install Iphone MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Iphone MCP safe to use with an AI agent?

Its trust score is 67 out of 100 (good). It passes 3 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Iphone MCP still maintained?

The last commit was a year ago and 1 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.