mcps-for-macos

Una colección de servidores MCP (Model Context Protocol) para la automatización de macOS. Cada servidor encapsula una aplicación o función del sistema mediante AppleScript o línea de comandos y los pone a disposición como herramientas que una aplicación de IA (Claude Desktop, Claude Code) puede invocar.

Los ayudantes comunes (ejecución de AppleScript con escape, ejecución de comandos) se encuentran en packages/common y son utilizados por los servidores como @mcps/common.

¿Qué es un servidor MCP?

MCP es un estándar abierto mediante el cual las aplicaciones de IA (el host) se comunican con herramientas y datos externos. Un servidor proporciona capacidades (herramientas) y no sabe nada sobre IA. Comunicación a través de JSON-RPC 2.0, aquí por stdio (proceso local). Registrar significa: indicar al host cómo iniciar el servidor. El host lo inicia como subproceso al inicio de cada sesión, consulta sus herramientas y las pone a disposición de la IA.

Related MCP server: macos-mcp-tools

Instalación

npm install

Un npm install en el directorio raíz es suficiente para todos los servidores (npm workspaces). Sin paso de compilación: JavaScript ESM puro, Node >= 18.

Registro

Cada servidor se registra individualmente, porque cada uno es un proceso propio. Las rutas deben indicarse de forma absoluta; <REPO> representa la ruta a este repositorio.

Claude Code

# global in allen Projekten (empfohlen für Systemwerkzeuge)
claude mcp add apple-calendar --scope user -- node <REPO>/packages/apple-calendar/src/index.js
claude mcp add apple-mail  --scope user -- node <REPO>/packages/apple-mail/src/index.js
claude mcp add money-money --scope user -- node <REPO>/packages/money-money/src/index.js
claude mcp add spotlight   --scope user -- node <REPO>/packages/spotlight/src/index.js

Sin --scope user, el registro solo se aplica al proyecto actual. Verificar y eliminar:

claude mcp list
claude mcp remove spotlight

Claude Desktop

En ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-calendar": { "command": "node", "args": ["<REPO>/packages/apple-calendar/src/index.js"] },
    "apple-mail":  { "command": "node", "args": ["<REPO>/packages/apple-mail/src/index.js"] },
    "money-money": { "command": "node", "args": ["<REPO>/packages/money-money/src/index.js"] },
    "spotlight":   { "command": "node", "args": ["<REPO>/packages/spotlight/src/index.js"] }
  }
}

Permisos de macOS

• Automatización. En el primer acceso, macOS solicita acceso de automatización a Mail, Calendario o MoneyMoney. Permitir una vez.

• Full Disk Access. Los lugares protegidos (p. ej., ~/Library/Mail) solo devuelven resultados con Full Disk Access para el proceso en ejecución (Ajustes del sistema → Privacidad y seguridad → Acceso total al disco).

Pruebas locales

Probar cada servidor individualmente con el MCP Inspector:

npm run inspect -w @mcps/spotlight

Licencia

MIT