Simctl Mcp

O que é simctl-mcp?

simctl-mcp é um repositório público hospedado no GitHub, criado pelo usuário ### ambar. Este projeto foi projetado para fornecer uma interface de linha de comando para gerenciar e controlar simuladores iOS. Ele simplifica o processo de interação com simuladores, permitindo que os desenvolvedores automatizem tarefas e otimizem seu fluxo de trabalho de desenvolvimento.

Recursos do simctl-mcp

• Interface de Linha de Comando: Oferece uma interface de linha de comando amigável para gerenciar simuladores iOS.
• Automação: Permite a automação de tarefas comuns, como iniciar simuladores, instalar aplicativos e executar testes.
• Compatibilidade Multiplataforma: Funciona perfeitamente em diferentes sistemas operacionais, tornando-o acessível para todos os desenvolvedores.
• Código Aberto: Sendo um repositório público, permite que os desenvolvedores contribuam, modifiquem e aprimorem a ferramenta conforme suas necessidades.
• Documentação: Documentação abrangente está disponível para ajudar os usuários a entender como utilizar a ferramenta de forma eficaz.

Como Usar o simctl-mcp

1. Instalação: Clone o repositório do GitHub usando o comando:

   git clone https://github.com/ambar/simctl-mcp.git
   

2. Navegue até o Diretório: Mude para o diretório do projeto:

   cd simctl-mcp
   

3. Execute Comandos: Use a interface de linha de comando para gerenciar simuladores. Por exemplo, para listar todos os simuladores disponíveis, você pode executar:

   ./simctl list
   

4. Automatize Tarefas: Crie scripts para automatizar tarefas repetitivas usando os comandos fornecidos pelo simctl-mcp.

Perguntas Frequentes

Em qual linguagem de programação o simctl-mcp foi escrito?

simctl-mcp é principalmente escrito em Python, tornando fácil para desenvolvedores familiarizados com a linguagem contribuírem.

O simctl-mcp é compatível com todas as versões do iOS?

Sim, o simctl-mcp foi projetado para funcionar com várias versões de simuladores iOS, garantindo compatibilidade em diferentes ambientes de desenvolvimento.

Posso contribuir para o simctl-mcp?

Absolutamente! Como é um projeto de código aberto, contribuições são bem-vindas. Você pode bifurcar o repositório, fazer suas alterações e enviar um pull request.

Onde posso encontrar a documentação do simctl-mcp?

A documentação está disponível dentro do próprio repositório, geralmente encontrada em um arquivo README.md ou em uma pasta dedicada docs.

Como posso relatar problemas ou bugs no simctl-mcp?

Você pode relatar problemas navegando até a aba "Issues" no repositório do GitHub e enviando um novo problema com detalhes sobre o problema que você encontrou.

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:

1. STDIO Mode (default)
2. 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)