mcps-for-macos

Коллекция MCP-серверов (Model Context Protocol) для автоматизации macOS. Каждый сервер инкапсулирует приложение или системную функцию через AppleScript или командную строку и предоставляет их как инструменты, которые может вызывать ИИ-приложение (Claude Desktop, Claude Code).

Общие помощники (выполнение AppleScript с экранированием, выполнение команд) находятся в packages/common и используются серверами как @mcps/common.

Что такое MCP-сервер?

MCP — это открытый стандарт, через который ИИ-приложения (хост) общаются с внешними инструментами и данными. Сервер предоставляет возможности (инструменты) и сам ничего не знает об ИИ. Связь через JSON-RPC 2.0, здесь через stdio (локальный процесс). Регистрация означает: указать хосту, как запускать сервер. Хост запускает его как подпроцесс при каждом начале сеанса, запрашивает его инструменты и предоставляет их ИИ.

Related MCP server: macos-mcp-tools

Установка

npm install

Достаточно npm install в корневом каталоге для всех серверов (npm workspaces). Без шага сборки: чистый ESM-JavaScript, Node >= 18.

Регистрация

Каждый сервер регистрируется отдельно, потому что каждый является отдельным процессом. Пути должны быть указаны абсолютными; <REPO> обозначает путь к этому репозиторию.

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

Без --scope user регистрация действует только в текущем проекте. Проверить и удалить:

claude mcp list
claude mcp remove spotlight

Claude Desktop

В ~/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"] }
  }
}

Разрешения macOS

• Автоматизация. При первом доступе macOS запрашивает разрешение на автоматизацию для Mail, Календарь или MoneyMoney. Разрешить один раз.

• Full Disk Access. Защищенные места (например, ~/Library/Mail) дают результаты только с Full Disk Access для выполняющего процесса (Системные настройки → Конфиденциальность и безопасность → Полный доступ к диску).

Локальное тестирование

Проверьте каждый сервер по отдельности с помощью MCP Inspector:

npm run inspect -w @mcps/spotlight

Лицензия

MIT