vphone-cli
vphone-cli is a command-line tool that boots virtual iPhones on Apple Silicon Macs using Apple's Virtualization.framework and PCC research VM infrastructure. It enables developers to create, configure, and manage iOS virtual machines with various firmware patch levels ranging from minimal patches to full jailbreak environments. The tool supports programmatic control via a host socket that can be wrapped by an MCP server for AI-driven end-to-end testing and automation.
Key Features
Use Cases
- 01AI-driven end-to-end testing of iOS applications using programmatic device control
- 02iOS security research and vulnerability analysis in isolated virtualized environments
- 03Automated iOS app testing workflows requiring jailbroken or customized environments
- 04Development and debugging of iOS apps without physical device dependencies
- 05Testing iOS behavior across multiple versions and patch configurations simultaneously
- 06Research on anti-VM detection and iOS sandbox mitigation techniques
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
vphone-cli — FAQ
What is vphone-cli?+
vphone-cli is a command-line tool that creates and manages virtual iPhone instances on Apple Silicon Macs using Apple's Virtualization.framework. It provides programmatic control via a host socket that can be wrapped by an MCP server for AI-driven automation and testing.
How do I install vphone-cli?+
Install via Homebrew with 'brew install zqxwce/tap/vphone-cli'. You must be running macOS 15+ on Apple Silicon with Xcode installed, and you need to relax SIP/AMFI restrictions to allow private virtualization entitlements.
What are the prerequisites for running vphone-cli?+
You need an Apple Silicon Mac running macOS 15 (Sequoia) or later, Xcode with iOS SDK, and SIP/AMFI relaxation via 'csrutil allow-research-guests enable' in Recovery mode. Additional dependencies are installed via Homebrew including Python 3.13, aria2, and several other tools.
Which MCP clients work with vphone-cli?+
The vphone-mcp server wrapper enables any MCP-compatible client to control vphone-cli instances. The host control socket provides screenshot, touch, swipe, and clipboard APIs suitable for AI-driven end-to-end testing workflows.
Is vphone-cli free to use?+
Yes, vphone-cli is open source and available on GitHub under the repository Lakr233/vphone-cli. However, you must have a valid Apple Silicon Mac and macOS 15+ to run it.
How do I connect to a running virtual iPhone?+
For jailbroken variants, use SSH on port 22222 with 'ssh -p 22222 mobile@<vm-ip>' (password 'alpine'). For regular/dev variants, connect as root. VNC is available at 'vnc://<vm-ip>:5901'.
How do I install vphone-cli?+
Open the source repository on GitHub and follow its README. vphone-cli is a mcp server — MCP Agents Market links you directly to the official repo.
Is vphone-cli free?+
vphone-cli is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.