macOS Utilities

mcp-macos-utils

Un servidor de Model Context Protocol (MCP) que proporciona herramientas de utilidades de macOS para asistentes de IA.

Características

• Notificaciones nativas de macOS: Envía notificaciones del sistema con diferentes tipos (éxito, error, información, advertencia)
• Detección automática de proyecto: Detecta automáticamente e incluye el nombre del proyecto actual en las notificaciones
• Registro de notificaciones: Todas las notificaciones se registran en ~/.mcp-notifications.log para seguimiento de auditoría
• Soporte de TypeScript: Completamente tipado para una mejor experiencia de desarrollo

Instalación

1. Clona este repositorio:

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

2. Ejecuta el script de instalación:

./install.sh

Esto hará lo siguiente:

• Instalar las dependencias de npm
• Compilar el código TypeScript
• Crear un archivo de configuración de ejemplo

Configuración

Añade lo siguiente al archivo de configuración de tu cliente MCP:

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

Reemplaza /absolute/path/to/mcp-macos-utils con la ruta real a este directorio.

Uso

Una vez configurado, la siguiente herramienta estará disponible para los asistentes de IA:

notify

Envía una notificación de macOS con contexto del proyecto.

Parámetros:

• title (obligatorio): El título de la notificación
• message (obligatorio): El mensaje de la notificación
• type (opcional): Tipo de notificación - success, error, info, o warning (por defecto: info)
• sound (opcional): Si se debe reproducir un sonido (por defecto: true)
• subtitle (opcional): Subtítulo personalizado (por defecto, el nombre del proyecto actual)

Ejemplo:

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

Tipos de notificación

• Éxito (✅): Para operaciones exitosas
• Error (❌): Para errores o fallos
• Advertencia (⚠️): Para advertencias o precauciones
• Información (ℹ️): Para información general

Registro

Todas las notificaciones se registran en ~/.mcp-notifications.log en formato JSON, incluyendo:

• Marca de tiempo
• Nombre del proyecto
• Tipo de notificación
• Título y mensaje
• Cualquier error que haya ocurrido

Desarrollo

Compilación

npm run build

Modo de desarrollo

npm run dev

Compilación limpia

npm run clean
npm run build

Requisitos

• macOS (utiliza osascript nativo para notificaciones)
• Node.js 20+
• TypeScript 5.5+

Licencia

MIT