Simctl Mcp
Aperçu
Qu'est-ce que simctl-mcp ?
simctl-mcp est un dépôt public hébergé sur GitHub, créé par l'utilisateur ### ambar. Ce projet est conçu pour fournir une interface en ligne de commande pour gérer et contrôler les simulateurs iOS. Il simplifie le processus d'interaction avec les simulateurs, permettant aux développeurs d'automatiser des tâches et d'optimiser leur flux de travail de développement.
Fonctionnalités de simctl-mcp
- Interface en ligne de commande : Offre une interface en ligne de commande conviviale pour gérer les simulateurs iOS.
- Automatisation : Permet l'automatisation des tâches courantes telles que le lancement de simulateurs, l'installation d'applications et l'exécution de tests.
- Compatibilité multiplateforme : Fonctionne sans problème sur différents systèmes d'exploitation, le rendant accessible à tous les développeurs.
- Open Source : Étant un dépôt public, il permet aux développeurs de contribuer, de modifier et d'améliorer l'outil selon leurs besoins.
- Documentation : Une documentation complète est disponible pour aider les utilisateurs à comprendre comment utiliser l'outil efficacement.
Comment utiliser simctl-mcp
- Installation : Clonez le dépôt depuis GitHub en utilisant la commande :
git clone https://github.com/ambar/simctl-mcp.git
- Naviguer dans le répertoire : Changez dans le répertoire du projet :
cd simctl-mcp
- Exécuter des commandes : Utilisez l'interface en ligne de commande pour gérer les simulateurs. Par exemple, pour lister tous les simulateurs disponibles, vous pouvez exécuter :
./simctl list
- Automatiser des tâches : Créez des scripts pour automatiser des tâches répétitives en utilisant les commandes fournies par simctl-mcp.
Questions Fréquemment Posées
Dans quel langage de programmation simctl-mcp est-il écrit ?
simctl-mcp est principalement écrit en Python, ce qui le rend facile à utiliser pour les développeurs familiers avec ce langage.
simctl-mcp est-il compatible avec toutes les versions d'iOS ?
Oui, simctl-mcp est conçu pour fonctionner avec diverses versions de simulateurs iOS, garantissant la compatibilité à travers différents environnements de développement.
Puis-je contribuer à simctl-mcp ?
Absolument ! Étant un projet open-source, les contributions sont les bienvenues. Vous pouvez forker le dépôt, apporter vos modifications et soumettre une demande de tirage.
Où puis-je trouver la documentation pour simctl-mcp ?
La documentation est disponible dans le dépôt lui-même, généralement dans un fichier README.md
ou un dossier docs
dédié.
Comment puis-je signaler des problèmes ou des bogues dans simctl-mcp ?
Vous pouvez signaler des problèmes en naviguant vers l'onglet "Issues" dans le dépôt GitHub et en soumettant un nouveau problème avec des détails sur le problème que vous avez rencontré.
Détail
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)
Configuration du serveur
{
"mcpServers": {
"simctl-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--ambar--simctl-mcp--simctl-mcp",
"pnpm run start"
],
"env": {}
}
}
}