Remote macOS Use

Um servidor MCP de código aberto que permite que a IA controle totalmente um sistema macOS remoto.

Documentação

MCP Server - Remote MacOs Use

O primeiro servidor MCP de código aberto que permite que a IA controle totalmente sistemas macOS remotos.

Uma alternativa direta ao OpenAI Operator, otimizada especificamente para agentes de IA autônomos com capacidades completas de desktop, sem exigir instalação de software adicional.

Demonstrações

Pesquisar no Twitter e publicar no Twitter (https://www.youtube.com/watch?v=--QHz2jcvcs)
Usar o CapCut para criar vídeo curto de destaques (https://www.youtube.com/watch?v=RKAqiNoU8ec)
Recrutador de IA: coleta automatizada de informações de candidatos, qualificação de inscrições e envio de sessões de triagem usando o aplicativo Mail
Estagiário de Marketing de IA: engajamento no LinkedIn - seguir, curtir e comentar automaticamente com usuários relevantes
Estagiário de Marketing de IA: engajamento no Twitter - seguir, curtir e comentar automaticamente com usuários relevantes

Lista de Tarefas (Priorizadas)

Otimização de Desempenho - Igualar a velocidade das alternativas de desktop Ubuntu
Geração de Scripts Apple - Reduzir o tempo de execução mantendo a flexibilidade
Visibilidade do Cursor VNC - Melhorar a experiência de depuração e demonstração

Aceitamos contribuições!

Recursos

Sem Custos Adicionais de API: Processamento de tela gratuito com seu plano Claude Pro existente
Configuração Mínima: Basta ativar o Compartilhamento de Tela no Mac de destino – nenhum software adicional é necessário
Compatibilidade Universal: Funciona com todas as versões do macOS, atuais e futuras

Por Que Construímos Isso

Experiência macOS Nativa Sem Compromissos

O ecossistema nativo do macOS permanece incomparável em experiência do usuário hoje e continuará sendo o padrão ouro por muitos anos. É aqui que as capacidades humanas realmente prosperam, e agora sua IA pode operar neste ambiente com a mesma fluência.

Arquitetura Aberta Por Design

Compatibilidade Universal com LLM: Trabalhe com qualquer Cliente MCP de sua escolha
Flexibilidade de Modelo: Integre-se perfeitamente com OpenAI, Anthropic ou qualquer outro provedor de LLM
Integração à Prova de Futuro: Projetada para evoluir com o ecossistema MCP

Implantação Sem Esforço

Zero Configuração nas Máquinas de Destino: Nenhum aplicativo em segundo plano ou agente necessário no macOS
Compartilhamento de Tela é Tudo que Você Precisa: Controle qualquer Mac com o Compartilhamento de Tela ativado
Elimine a Complexidade do Backend: Diferente de outras soluções que exigem executar aplicativos Python ou serviços em segundo plano

Processo de Inicialização Simplificado

Aproveite a UI Polida do Claude Desktop: Sem necessidade de interfaces Python estilo desenvolvedor
Experiência de Usuário Intuitiva: Interaja com seu Mac controlado por IA através de uma interface familiar e amigável
Produtividade Instantânea: Comece a trabalhar imediatamente sem complicações de configuração

Arquitetura

Instalação

Ative o Compartilhamento de Tela no macOS Se você alugar um Mac da macstadium.com, pode pular esta etapa
Conecte-se ao seu macOS remoto
Instale o Docker Desktop para Mac local
Adicione este servidor MCP ao Claude Desktop Você pode configurar o Claude Desktop para usar a imagem Docker adicionando o seguinte à sua configuração do Claude:

{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME=your_macos_username",
        "-e",
        "MACOS_PASSWORD=your_macos_password",
        "-e",
        "MACOS_HOST=your_macos_hostname_or_ip",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ]
    }
  }
}

Suporte a WebRTC via LiveKit

Este servidor agora inclui suporte a WebRTC através da integração com LiveKit, permitindo:

Compartilhamento de tela em tempo real com baixa latência
Desempenho e capacidade de resposta melhorados
Melhor eficiência de rede comparada ao VNC tradicional
Adaptação automática de qualidade com base nas condições da rede

Para usar os recursos WebRTC, você precisará:

Configurar um servidor LiveKit ou usar o LiveKit Cloud
Configurar as variáveis de ambiente do LiveKit conforme mostrado no exemplo de configuração acima

Instruções para Desenvolvedores

Clone o repositório

# Clone the repository
git clone https://github.com/yourusername/mcp-remote-macos-use.git
cd mcp-remote-macos-use

Construindo a Imagem Docker

# Build the Docker image
docker build -t mcp-remote-macos-use .

Publicação Multiplataforma

Para publicar a imagem Docker para múltiplas plataformas, você pode usar o comando docker buildx. Siga estes passos:

Crie uma nova instância de builder (se ainda não tiver):
```
docker buildx create --use
```

Construa e envie a imagem para múltiplas plataformas:

docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-remote-macos-use:latest --push .

Verifique se a imagem está disponível para as plataformas especificadas:
```
docker buildx imagetools inspect buryhuang/mcp-remote-macos-use:latest
```

Uso

O servidor fornece funcionalidade Remote MacOs através de ferramentas MCP.

Especificações das Ferramentas

O servidor fornece as seguintes ferramentas para controle remoto do macOS:

remote_macos_get_screen

Conecte-se a uma máquina macOS remota e obtenha uma captura de tela da área de trabalho remota. Usa variáveis de ambiente para detalhes de conexão.

remote_macos_send_keys

Envie entrada de teclado para uma máquina macOS remota. Usa variáveis de ambiente para detalhes de conexão.

remote_macos_mouse_move

Mova o cursor do mouse para coordenadas especificadas em uma máquina macOS remota, com dimensionamento automático de coordenadas. Usa variáveis de ambiente para detalhes de conexão.

remote_macos_mouse_click

Execute um clique do mouse em coordenadas especificadas em uma máquina macOS remota, com dimensionamento automático de coordenadas. Usa variáveis de ambiente para detalhes de conexão.

remote_macos_mouse_double_click

Execute um clique duplo do mouse em coordenadas especificadas em uma máquina macOS remota, com dimensionamento automático de coordenadas. Usa variáveis de ambiente para detalhes de conexão.

remote_macos_mouse_scroll

Execute uma rolagem do mouse em coordenadas especificadas em uma máquina macOS remota, com dimensionamento automático de coordenadas. Usa variáveis de ambiente para detalhes de conexão.

remote_macos_open_application

Abre/ativa um aplicativo e retorna seu PID para interações adicionais.

remote_macos_mouse_drag_n_drop

Execute uma operação de arrastar e soltar do ponto inicial ao ponto final em uma máquina macOS remota, com dimensionamento automático de coordenadas.

Todas as ferramentas usam as variáveis de ambiente configuradas durante a instalação em vez de exigir parâmetros de conexão.

Limitações

Suporte a Autenticação:
- Apenas Autenticação Apple (protocolo 30) é suportada

Nota de Segurança

https://support.apple.com/guide/remote-desktop/encrypt-network-data-apdfe8e386b/mac https://cafbit.com/post/apple_remote_desktop_quirks/

Suportamos apenas o protocolo 30, que usa o protocolo de acordo de chaves Diffie-Hellman com um primo de 512 bits. Este protocolo é usado pelo macOS 11 ao macOS 12 ao se comunicar com clientes OS X 10.11 ou anteriores.

Aqui estão as informações convertidas em uma tabela markdown:

Versão do macOS executando Remote Desktop	Versão do cliente macOS	Autenticação	Controle e Observação	Copiar itens ou instalar pacote	Todas as outras tarefas	Versão do Protocolo
macOS 13	macOS 13	Chaves de host RSA de 2048 bits	Chaves de host RSA de 2048 bits	Chaves de host RSA de 2048 bits para autenticar, depois AES de 128 bits	Chaves de host RSA de 2048 bits	36
macOS 13	macOS 10.12	Protocolo Secure Remote Password (SRP) apenas para local. Diffie-Hellman (DH) se vinculado ao LDAP ou se o servidor macOS for versão 10.11 ou anterior	SRP ou DH, AES de 128 bits	SRP ou DH para autenticar, depois AES de 128 bits	Chaves de host RSA de 2048 bits	35
macOS 11 ao macOS 12	macOS 10.12 ao macOS 13	Protocolo Secure Remote Password (SRP) apenas para local, Diffie-Hellman se vinculado ao LDAP	SRP ou DH de 1024 bits, AES de 128 bits	Chaves de host RSA de 2048 bits macOS 13 ao macOS 10.13	Chaves de host RSA de 2048 bits macOS 10.13 ou posterior	33
macOS 11 ao macOS 12	OS X 10.11 ou anterior	DH de 1024 bits	DH de 1024 bits, AES de 128 bits	Protocolo de acordo de chaves Diffie-Hellman com um primo de 512 bits	Protocolo de acordo de chaves Diffie-Hellman com um primo de 512 bits	30

Sempre use conexões seguras e autenticadas ao acessar máquinas macOS remotas. Esta ferramenta deve ser usada apenas com servidores em que você confia e tem permissão para acessar.

Licença

Consulte o arquivo LICENSE para obter detalhes.