Simctl Mcp
Panoramica
Cos'è simctl-mcp?
simctl-mcp è un repository pubblico ospitato su GitHub, creato dall'utente ### ambar. Questo progetto è progettato per fornire un'interfaccia a riga di comando per gestire e controllare gli simulatori iOS. Semplifica il processo di interazione con gli simulatori, consentendo agli sviluppatori di automatizzare compiti e ottimizzare il loro flusso di lavoro di sviluppo.
Caratteristiche di simctl-mcp
- Interfaccia a Riga di Comando: Offre un'interfaccia a riga di comando user-friendly per gestire gli simulatori iOS.
- Automazione: Consente l'automazione di compiti comuni come l'avvio degli simulatori, l'installazione delle app e l'esecuzione dei test.
- Compatibilità Cross-Platform: Funziona senza problemi su diversi sistemi operativi, rendendolo accessibile a tutti gli sviluppatori.
- Open Source: Essendo un repository pubblico, consente agli sviluppatori di contribuire, modificare e migliorare lo strumento secondo le proprie esigenze.
- Documentazione: È disponibile una documentazione completa per aiutare gli utenti a capire come utilizzare lo strumento in modo efficace.
Come Usare simctl-mcp
- Installazione: Clona il repository da GitHub usando il comando:
git clone https://github.com/ambar/simctl-mcp.git - Naviga nella Directory: Cambia nella directory del progetto:
cd simctl-mcp - Esegui Comandi: Usa l'interfaccia a riga di comando per gestire gli simulatori. Ad esempio, per elencare tutti gli simulatori disponibili, puoi eseguire:
./simctl list - Automatizza Compiti: Crea script per automatizzare compiti ripetitivi utilizzando i comandi forniti da simctl-mcp.
Domande Frequenti
In quale linguaggio di programmazione è scritto simctl-mcp?
simctl-mcp è principalmente scritto in Python, rendendolo facile per gli sviluppatori familiari con il linguaggio di contribuire.
È simctl-mcp compatibile con tutte le versioni di iOS?
Sì, simctl-mcp è progettato per funzionare con varie versioni degli simulatori iOS, garantendo compatibilità tra diversi ambienti di sviluppo.
Posso contribuire a simctl-mcp?
Assolutamente! Poiché è un progetto open-source, sono benvenute le contribuzioni. Puoi forkare il repository, apportare le tue modifiche e inviare una pull request.
Dove posso trovare la documentazione per simctl-mcp?
La documentazione è disponibile all'interno del repository stesso, solitamente trovata in un file README.md o in una cartella dedicata docs.
Come posso segnalare problemi o bug in simctl-mcp?
Puoi segnalare problemi navigando nella scheda "Issues" nel repository GitHub e inviando un nuovo problema con dettagli sul problema che hai riscontrato.
Dettaglio
simctl-mcp
A Model Context Protocol server implementation for iOS Simulator control.
Config
.cursor/mcp.json or .vscode/mcp.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:
- STDIO Mode (default)
- HTTP Server Mode
STDIO Mode
In STDIO mode, the server communicates through standard input/output streams.
npx simctl-mcp
HTTP Server Mode
In HTTP server mode, the server listens for HTTP connections on a specified port.
### 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)
Configurazione Server
{
"mcpServers": {
"simctl-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--ambar--simctl-mcp--simctl-mcp",
"pnpm run start"
],
"env": {}
}
}
}
