Repolode
Enviar
jfarcand

jfarcand/mirroir-mcp

Um servidor MCP que permite a qualquer agente de IA controlar um iPhone comum pelo iPhone Mirroring do macOS, sem Developer Mode, Xcode ou WebDriverAgent.

Ver no GitHubSite
Estrelas
281
Forks
38
Issues abertas
3
Último commit
há 4 horas

O que é?

mirroir-mcp é um servidor MCP para macOS que controla um iPhone real, sem modificações, pelo recurso iPhone Mirroring da Apple. Um cliente de IA pode observar a tela com OCR ou visão computacional e, em seguida, tocar, deslizar, digitar e pressionar teclas do sistema. Como funciona na própria tela do celular, consegue acessar apps da App Store que o usuário não poderia compilar ou instrumentar por conta própria.

Além do ciclo básico de controle, oferece ferramentas de nível mais alto para navegação, rolagem e gerenciamento do ciclo de vida dos apps. Um agente pode explorar um app em largura e gerar fluxos de trabalho SKILL.md. As skills podem ser compiladas para reprodução sem LLM pela CLI `mirroir test`, com saída JUnit e um veredito específico de divergência para uso em CI.

O projeto também inclui `mirroir-run`, um runner em Rust que combina etapas no iPhone com etapas web (Playwright), HTTP e subprocessos em um único cenário. A parte de iOS requer um Mac conectado ao iPhone Mirroring; as demais superfícies funcionam no Linux.

Recursos principais

  • 01Controla um iPhone comum pelo iPhone Mirroring, com toques, deslizes, digitação e entrada de teclas.
  • 02Lê a tela com OCR do Apple Vision, detecção opcional de ícones com YOLO ou modo de visão por IA.
  • 03Funciona com qualquer cliente MCP e disponibiliza 38 ferramentas.
  • 04Explora apps e gera skills SKILL.md que podem ser reproduzidas.
  • 05Reproduz skills compiladas pela CLI sem LLM, com relatórios JUnit.
  • 06Por padrão, bloqueia ações quando há dúvidas, com configuração de permissões e listas de apps bloqueados.

Casos de uso

  • Executar testes smoke de ponta a ponta em apps da App Store que não podem ser instrumentados.
  • Permitir que um assistente de IA realize tarefas cotidianas no celular, como enviar mensagens ou criar eventos no calendário.
  • Gravar um passo a passo manual e reproduzi-lo como cenário de CI.
  • Combinar verificações no iPhone com verificações de páginas web em um único teste entre diferentes superfícies.

Início rápido

  1. 1

    Instale o servidor via npx (requer macOS 15 ou posterior e Espelhamento do iPhone)

    npx -y mirroir-mcp install
  2. 2

    Quando o macOS solicitar na primeira captura de tela, conceda as permissões de Gravação de Tela e Acessibilidade

  3. 3

    Registre o mirroir como um servidor MCP no Claude Code

    claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp

Antes de usar

  • Funciona apenas no macOS 15 ou posterior com o Espelhamento do iPhone; não oferece suporte a Android nem ao iOS Simulator.
  • Jogos com controles que exigem reflexos rápidos ou multitoque não são compatíveis, pois o Espelhamento do iPhone disponibiliza apenas um ponteiro.

Em coleções

Servidores MCP para Claude CodeFerramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceServidores MCPApps open source para MacFrameworks de teste e ferramentas de automação de testes

Tópicos

#mcp#ios-automation#mobile-testing#computer-use#ai-agent#macos#test-automation#ai-testing#appium-alternative#claude-code

Perguntas frequentes

O que é mirroir-mcp?
Um servidor MCP que permite a qualquer agente de IA controlar um iPhone comum pelo iPhone Mirroring do macOS, sem Developer Mode, Xcode ou WebDriverAgent. mirroir-mcp é um servidor MCP para macOS que controla um iPhone real, sem modificações, pelo recurso iPhone Mirroring da Apple. Um cliente de IA pode observar a tela com OCR ou visão computacional e, em seguida, tocar, deslizar, digitar e pressionar teclas do sistema. Como funciona na própria tela do celular, consegue acessar apps da App Store que o usuário não poderia compilar ou instrumentar por conta própria.
mirroir-mcp é gratuito? Qual é a licença?
mirroir-mcp é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
mirroir-mcp ainda é mantido?
Manutenção ativa. O último commit de mirroir-mcp foi em 6 de nov. de 2026.
Para que posso usar mirroir-mcp?
Executar testes smoke de ponta a ponta em apps da App Store que não podem ser instrumentados. Permitir que um assistente de IA realize tarefas cotidianas no celular, como enviar mensagens ou criar eventos no calendário. Gravar um passo a passo manual e reproduzi-lo como cenário de CI. Combinar verificações no iPhone com verificações de páginas web em um único teste entre diferentes superfícies.
Como instalar mirroir-mcp?
Instale o servidor via npx (requer macOS 15 ou posterior e Espelhamento do iPhone): npx -y mirroir-mcp install Quando o macOS solicitar na primeira captura de tela, conceda as permissões de Gravação de Tela e Acessibilidade Registre o mirroir como um servidor MCP no Claude Code: claude mcp add --transport stdio mirroir -- npx -y mirroir-mcp
Onde consigo mirroir-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jfarcand/mirroir-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados