macOS Utilities

mcp-macos-utils

Um servidor Model Context Protocol (MCP) que fornece ferramentas de utilitários do macOS para assistentes de IA.

Recursos

• Notificações Nativas do macOS: Envia notificações do sistema com diferentes tipos (sucesso, erro, informação, aviso)
• Detecção Automática de Projeto: Detecta e inclui automaticamente o nome do projeto atual nas notificações
• Registro de Notificações: Todas as notificações são registradas em ~/.mcp-notifications.log para trilha de auditoria
• Suporte a TypeScript: Totalmente tipado para melhor experiência de desenvolvimento

Instalação

1. Clone este repositório:

git clone <repository-url>
cd mcp-macos-utils

2. Execute o script de instalação:

./install.sh

Isso irá:

• Instalar dependências do npm
• Compilar o código TypeScript
• Criar um arquivo de configuração de exemplo

Configuração

Adicione o seguinte ao arquivo de configuração do seu cliente MCP:

{
  "mcpServers": {
    "macos-utils": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-macos-utils/dist/index.js"],
      "env": {}
    }
  }
}

Substitua /absolute/path/to/mcp-macos-utils pelo caminho real para este diretório.

Uso

Uma vez configurado, a seguinte ferramenta estará disponível para assistentes de IA:

notify

Envia uma notificação do macOS com contexto do projeto.

Parâmetros:

• title (obrigatório): O título da notificação
• message (obrigatório): A mensagem da notificação
• type (opcional): Tipo de notificação - success, error, info ou warning (padrão: info)
• sound (opcional): Se deve reproduzir um som (padrão: true)
• subtitle (opcional): Subtítulo personalizado (padrão: nome do projeto atual)

Exemplo:

await notify({
  title: "Build Complete",
  message: "Your project has been built successfully",
  type: "success"
});

Tipos de Notificação

• Sucesso (✅): Para operações bem-sucedidas
• Erro (❌): Para erros ou falhas
• Aviso (⚠️): Para avisos ou precauções
• Informação (ℹ️): Para informações gerais

Registro

Todas as notificações são registradas em ~/.mcp-notifications.log em formato JSON, incluindo:

• Carimbo de data/hora
• Nome do projeto
• Tipo de notificação
• Título e mensagem
• Quaisquer erros que ocorreram

Desenvolvimento

Compilação

npm run build

Modo de Desenvolvimento

npm run dev

Compilação Limpa

npm run clean
npm run build

Requisitos

• macOS (usa osascript nativo para notificações)
• Node.js 20+
• TypeScript 5.5+

Licença

MIT