witchan/ios-mcp
Developer toolsThis page was translated automatically. Technical details may differ from the original. View the original
IOS Automation Tool and MCP Server for iPhone Screens and Directly Operating Mobile Phones for AI assistants such as Claude, Codex, Cursor, to support UI tree acquisition, element positioning, transmap and OCR recognition, click slide, text input, application management and log reading, for automated testing and iOS reverse debugging
Overview
iOS MCP is a MCP (Model Contact Protocol) server that runs on an iPhone escape, allowing AI agents (Claude, Codex, Cursor, etc.) to directly manipulate iOS equipment. Install app supports .ipa, tipa and .deb. .tipa installs by IPA; documents on a computer must be uploaded via POST /upload file before sending the returned device path to install app. ocr screen and describe screen (include ocr=true) support the optional parameters engine: omit or pass "paddleocr" to use PaddleOCR + ONNX Runtime CPU; pass "vision" to use Apple Vision. The selection only affects the current request and failure does not automatically change the engine. Vision recognizes English by default in iOS 13; PaddleOCR supports Chinese English and numbers. See OCR engine documents for building dependence, examples of parameters and validation instructions. - MobileSublate/ElleKit - contributionloader Opens the device "Setting" "iOS MCP" after installation, and click on "Replicate and Share MCP Tip Snippet" after startup, and paste it into your AI tip. - MCP service has no built-in authentication and is recommended to be used only in the local area network environment - MCP protocol default support 2025-06-18, 2025-03-26; HTTP response returns MCP-Protocol-Version - lock or shut down, service-end intercepts access to interactive/written tools such as clicks, slides, input, App, Shell, etc., and only releases status queries, screenshots and resuscitation tools - Run Command tool executes any shell command, use - read file/write file/download file file, consistent with run command risk level, use only - get syslog through mcp-reader (signature.applet. logging.
Overview (machine translated)
Chinese
iOS MCP is a MCP (Model Contact Protocol) server that runs on an iPhone escape, allowing AI agents (Claude, Codex, Cursor, etc.) to directly manipulate iOS equipment.
Overview of functions
| Class | Tools | Description |
| | | | | |
** Touching gesture** [[T0] [[T1] [[T2] double_tap``drag_and_drop | precision screen coordinate operation to support path drag] **
** Hardware ** [[T5] [[T6] [[T7] [[T9] toggle_mute [[T10] | HID Simulation Physical Keys, Lock/Banking Awakening]
** Text input** [[T11] [(T12]]press_key ** Clipboard quick input / HID word-by-word simulation / special keys] |
** Interception** [T14] [[T15] | Base64 JPEG transposition, screen size and direction
App Management ** [T16] [(T17] [(T19]]] get_frontmost_app[T21] install_app``uninstall_app | Start/off App, install/dismount App or Deb, query App Sandbox/container path and entitlements |
** Accessibility [T24] [[T25] [[T26] wait_for_element ocr_screen``describe_screen | Access to UI nodal tree, coordinate element query, text/label click on element, waiting for element to appear or disappear, screen OCR text recognition and positioning, aggregate screen snapshots
** Clipboard**
** Documentation system** [(T33] [[T34] [(T35]]] Catalogue listing, document reading and writing (support text and binary) |
** Log** [(T36] [(T37]][T38] | All App Real-Time System Logs, Crash Log Listing and Reading]
This page was translated automatically. Technical details may differ from the original.
Install
This server does not publish a one-line install command.
Open the repository installation guide New to MCP? Start with the mcpskill.org guide →