https://github.com/ambar/simctl-mcp
https://github.com/ambar/simctl-mcp
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/ambar/simctl-mcp
- Owner: ambar
- License: mit
- Created: 2025-03-28T01:26:47.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-03-30T03:18:24.000Z (2 months ago)
- Last Synced: 2025-03-30T03:26:55.671Z (2 months ago)
- Language: TypeScript
- Size: 26.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# simctl-mcp
A Model Context Protocol server implementation for iOS Simulator control.
## Config
`.cursor/mcp.json` or `.vscode/mcp.json`:
```json
{
"mcpServers": {
"simctl-mcp": {
"command": "npx",
"args": ["-y", "simctl-mcp"]
}
}
}
```
## Prompts
Some examples of prompts:
- What operations does the simulator support?
- Open shortcuts://
- What is the bundle ID of the "Settings" app?
- Set clipboard content to: Hello
- What is the simulator SDK version?
- Generate an Appium connection string for the "Settings" app
## Usage
The server can be started in two modes:
1. STDIO Mode (default)
2. HTTP Server Mode
### STDIO Mode
In STDIO mode, the server communicates through standard input/output streams.
```bash
npx simctl-mcp
```
### HTTP Server Mode
In HTTP server mode, the server listens for HTTP connections on a specified port.
```bash
# Start with default port (8081)
npx simctl-mcp --http
# Start with custom port using --port flag
npx simctl-mcp --http --port 3000
# Start with custom port using environment variable
PORT=3000 npx simctl-mcp --http
```
## Tools
## Device Management:
- Create new simulator devices
- Delete existing devices
- Boot devices
- Shutdown devices
- List all available devices
- List available device types
- List available runtimes
## App Management:
- Install apps
- Uninstall apps
- Launch apps
- Terminate running apps
- Get app container path
- Get app information
- List installed apps
## App Permissions:
- Grant permissions to apps
- Revoke app permissions
- Reset all app permissions
## System Features:
- Open URLs in simulator
- Add media files
- Get/Set environment variables
- Get/Set appearance (light/dark mode)
- Send simulated push notifications
## Certificate & Security:
- Add root certificates
- Add regular certificates
- Reset keychain
## Media & Content:
- Take screenshots
- Get/Set pasteboard content (clipboard)