Sobre o projeto

O Mobile MCP é um servidor do Model Context Protocol (MCP) para desenvolvimento e automação móvel. Expõe uma interface agnóstica de plataforma para que agentes e LLMs possam interagir com aplicações nativas iOS e Android sem precisar de conhecimentos separados de iOS ou Android. Funciona com clientes compatíveis com MCP, como Claude Code, Codex, Gemini, GitHub Copilot e Antigravity, e pode ter como alvo dispositivos na máquina local ou dispositivos remotos através de um serviço de nuvem alojado. Os alvos suportados incluem simuladores iOS (via Xcode e xcrun simctl), dispositivos iOS reais ligados por USB, emuladores Android (via adb) e dispositivos Android reais com depuração USB ativada. O servidor é distribuído como pacote npm e é normalmente iniciado com npx, seja por stdio ou como servidor HTTP Streamable usando a flag --listen. Um token Bearer opcional pode ser exigido para o modo HTTP através de uma variável de ambiente. O conjunto de ferramentas abrange gestão de dispositivos (listar dispositivos, tamanho do ecrã, obter/definir orientação, substituição de localização GPS, leitura/substituição da área de transferência), gestão de aplicações (listar, aplicação em primeiro plano, iniciar, terminar, instalar, desinstalar), interação com o ecrã (capturas de ecrã, guardar capturas de ecrã, listar elementos de UI com coordenadas, toques, toques duplos, pressão longa, deslizes, gravação de ecrã), entrada e navegação (escrever texto, botões de hardware, abrir URLs) e registos e relatórios de falhas (registos do dispositivo, listagem e obtenção de falhas). Uma ferramenta de comando em lote executa várias ferramentas em sequência numa só chamada. As ferramentas de dispositivos remotos permitem iniciar sessão num fornecedor de nuvem, listar, alocar e libertar dispositivos na nuvem. O projeto dá ênfase a uma abordagem centrada na acessibilidade: controla as aplicações a partir da árvore de acessibilidade nativa em vez de um modelo de visão, recorrendo a capturas de ecrã e coordenadas quando necessário, o que o README apresenta como mais rápido e mais barato do que abordagens baseadas apenas em capturas de ecrã. A saída é descrita como estruturada e determinística. Os pré-requisitos incluem as ferramentas de linha de comandos do Xcode, as ferramentas de plataforma Android, Node.js v20 ou superior e um agente compatível com MCP. São fornecidos exemplos de configuração para muitos clientes, incluindo Amp, Antigravity, Cline, Claude Code, Claude Desktop, Codex, Copilot, Cursor, Gemini CLI, Goose, Kiro, open e Windsurf. Variáveis de ambiente controlam a autenticação, a exclusão de telemetria, esquemas de URL não seguros e um modo robot legado. A telemetria anónima é recolhida por predefinição e pode ser desativada. O repositório também aponta para projetos relacionados: mobilewright para testes móveis determinísticos e repetíveis, mobilecli como a CLI de dispositivos subjacente e uma oferta de nuvem para dispositivos reais a pedido. Estão ligados documentação, um roadmap, diretrizes de contribuição e um código de conduta. O README afirma que o servidor é executado localmente e comunica apenas com dispositivos, com uma política de privacidade separada para detalhes sobre a recolha de dados.