About Bridge4simulator
Bridge4simulator is an MCP server published by AppGram in the Developer Tools category: an MCP (Model Context Protocol) server that enables AI assistants to control iOS Simulator. Seamlessly integrates with Claude Desktop, Cursor, Claude Code, and other MCP-compatible clients. It has been installed 0 times through Conduid.
The repository has 77 stars and 4 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
npx bridge4simulatorThis 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.
Ask AI
Ask AI about Bridge4simulator
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
bridge4simulator MCP Server
MCP Server for iOS Simulator Control
Watch full video on YouTube
An MCP (Model Context Protocol) server that enables AI assistants to control iOS Simulator. Seamlessly integrates with Claude Desktop, Cursor, Claude Code, and other MCP-compatible clients.
Be sure to drop a ⭐️ if you find this project useful.
Quick Install
Brew:
brew tap AppGram/tap
brew install bridge4simulator
bridge4simulator --version
Installer:
curl -fsSL https://github.com/AppGram/bridge4simulator/releases/latest/download/install.sh | bash
Under the hood, MCP relies on a custom-built bridge. For inquiries about commercial use of the tool powering this CLI, be free to contact us
Configuration
First run, in terminal:
bridge4simulator mcp --http
Cursor IDE
Go to Settings > MCP and add:
Then add config
"bridge4simulator": {
"url": "http://localhost:8080/mcp"
},
Or in Claude Desktop config:
{
"mcpServers": {
"bridge4simulator": {
"command": "/usr/local/bin/bridge4simulator",
"args": ["mcp", "--enable-tools=screenshot"]
}
}
}
Claude Desktop doesn't support url for local development MCPs.
Claude Code CLI
Add to ~/.claude/settings.json or project .mcp.json:
{
"mcpServers": {
"ios-simulator": {
"command": "/usr/local/bin/bridge4simulator",
"args": ["mcp", "--enable-tools=screenshot"]
}
}
}
Demo
This demo highlights autonomous navigation and the internal reasoning process behind task execution. Under the hood, MCP uses a powerful CLI tool that enables instant OCR and UI extraction while keeping token consumption minimal for rapid problem solving.
| Apple Calendar Demo | Apple Maps Demo |
|---|---|
| Task was to create an event on specific date. Click to watch. | Task is to find train route from Rome to Padova. Click to watch. |
Available Tools (21)
| Category | Tools | Description |
|---|---|---|
| Device | device_list, device_boot, device_shutdown, status |
Manage simulator devices |
| Input | tap, swipe, type_text |
Touch gestures and text input |
| Capture | screenshot, record_start, record_stop |
Screen capture and recording |
| Apps | app_install, app_launch, app_terminate |
Application lifecycle |
| Navigation | open_url |
Open URLs and deep links |
| UI | ui_describe, ui_find, ui_search, ui_summary, ui_point, ui_ocr |
Accessibility tree and OCR |
| Macros | macro_play, macro_list |
Automation sequences |
Example Workflows
Once configured, ask your AI assistant:
UI Interaction:
"Find train route between Rome and Florance inside running app"
Screenshot & Analysis:
"Take a screenshot of the iOS Simulator and describe what's on screen"
Navigation:
"Scroll down the list and find the settings option"
App Testing:
"Launch the app com.example.myapp and take a screenshot"
Requirements
- Xcode Command Line Tools
- iOS Simulator (via Xcode)
Manual Download
| Platform | Download |
|---|---|
| Apple Silicon (M1/M2/M3/M4/M5) | bridge4simulator-darwin-arm64.tar.gz |
| Intel Macs | bridge4simulator-darwin-amd64.tar.gz |
Running the Server
# Start MCP server (JSON-RPC over stdio)
bridge4simulator mcp
The server reads JSON-RPC 2.0 requests from stdin and writes responses to stdout.
Support
- Documentation: GitHub
- Issues: GitHub Issues
- Email: support@appgram.dev
Version 1.0.0 | AppGram
README mirrored from the source repository yesterday. The original is authoritative.