AppleScript MCP Server

O que faz o “AppleScript” MCP Server?

O AppleScript MCP Server é um servidor Model Context Protocol (MCP) projetado para fornecer a assistentes de IA e ferramentas de desenvolvimento a capacidade de executar código AppleScript em um Mac. Atuando como uma ponte, ele permite que agentes de IA acessem e controlem aplicativos e funções do sistema Mac, como interagir com Notas, Calendário, Contatos, Mensagens e outros. O servidor suporta tarefas como busca de arquivos via Spotlight, leitura e escrita de arquivos, execução de comandos no shell, e até execução remota via SSH. Seu design leve e intuitivo facilita a integração, ampliando significativamente a automação, produtividade e o fluxo de desenvolvimento para usuários Mac, ao permitir acesso programático a uma ampla variedade de recursos do macOS.

Lista de Prompts

Não há templates de prompt reutilizáveis documentados no repositório. Apenas exemplos de prompts para o usuário são fornecidos.

Lista de Recursos

Não há recursos MCP explícitos descritos na documentação ou código disponível.

Lista de Ferramentas

Não há um detalhamento de ferramentas fornecido no server.js ou na documentação. O servidor permite a execução de AppleScript arbitrário, mas primitivas específicas de ferramentas não são enumeradas.

Casos de Uso deste MCP Server

• Automação de Aplicativos Mac: Permite que desenvolvedores e agentes de IA automatizem fluxos de trabalho envolvendo Notas, Calendário, Contatos, Mensagens e outros aplicativos do macOS executando comandos AppleScript.
• Gerenciamento de Arquivos e Sistema: Habilita a busca de arquivos usando Spotlight ou Finder, leitura e escrita de conteúdos de arquivos e gerenciamento de pastas e documentos programaticamente.
• Obtenção de Informações do Sistema: Facilita consultas sobre o status do sistema, como porcentagem da bateria, espaço em disco e aplicativos em execução, útil tanto para usuários quanto para agentes automatizados.
• Execução Remota: Suporta a execução remota de AppleScript via SSH, tornando possível gerenciar um Mac a partir de outra máquina ou container.
• Controle de Mídia e Comunicação: Oferece controle sobre reprodução de mídia (por exemplo, no Apple Music) e pode interagir com apps de comunicação para automatizar e-mails, mensagens ou lembretes.

Como configurar

Windsurf

1. Certifique-se de que o Node.js está instalado em seu sistema.
2. Abra o arquivo de configuração do Windsurf.
3. Adicione o AppleScript MCP Server à sua seção mcpServers usando o trecho JSON abaixo.
4. Salve a configuração e reinicie o Windsurf.
5. Verifique se o servidor está em execução e acessível.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude

1. Certifique-se de que o Node.js está instalado.
2. Localize e abra o arquivo de configuração do Claude.
3. Adicione o servidor MCP conforme o exemplo abaixo.
4. Salve a configuração e reinicie o Claude.
5. Confirme que o servidor MCP está disponível para uso.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor

1. Instale o Node.js em seu sistema.
2. Abra o arquivo de configuração do Cursor.
3. Insira a entrada do AppleScript MCP server na seção mcpServers.
4. Salve e reinicie o Cursor.
5. Verifique se a integração foi bem-sucedida.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cline

1. Verifique se o Node.js está instalado.
2. Edite o arquivo de configuração do Cline.
3. Adicione a configuração do MCP server conforme o exemplo abaixo.
4. Salve as alterações e reinicie o Cline.
5. Teste para garantir que o MCP server está operacional.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Protegendo Chaves de API e Credenciais

Para execução remota, informações sensíveis como usuário e senha SSH podem ser fornecidas via variáveis de ambiente para maior segurança. Exemplo:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ],
      "env": {
        "REMOTE_USER": "seuusuario",
        "REMOTE_PASSWORD": "suasenha"
      },
      "inputs": {
        "remoteHost": "host.docker.internal"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "applescript_execute": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/caminhoparamcp/url"
  }
}

Depois de configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “applescript_execute” para o nome real do seu servidor MCP e substituir a URL pela sua própria URL do MCP server.

Visão Geral

Com base nas tabelas acima, o AppleScript MCP Server oferece uma integração direta porém limitada. Sua força está no controle direto do Mac via AppleScript. Entretanto, faltam templates de prompt documentados, recursos MCP explícitos e primitivas detalhadas de ferramentas. A presença de licença, popularidade moderada e instruções de configuração claras são pontos positivos. No geral, é altamente útil para seu nicho, mas a profundidade da documentação poderia ser melhor.

Score do MCP