mcps-for-macos

macOS自動化のためのMCPサーバー（Model Context Protocol）コレクション。 各サーバーは、AppleScriptまたはコマンドラインを介してアプリまたはシステム機能をカプセル化し、AIアプリケーション（Claude Desktop、Claude Code）が呼び出せるツールとして提供します。

共通ヘルパー（エスケープ処理を含むAppleScript実行、コマンド実行）はpackages/commonにあり、サーバーから@mcps/commonとして使用されます。

MCPサーバーとは？

MCPは、AIアプリケーション（ホスト）が外部ツールやデータと通信するためのオープン標準です。サーバーは機能（ツール）を提供し、それ自体はAIについて何も知りません。通信はJSON-RPC 2.0を介して行われ、ここではstdio（ローカルプロセス）を使用します。登録とは、サーバーの起動方法をホストに伝えることです。ホストはセッション開始のたびにサーバーをサブプロセスとして起動し、そのツールを照会してAIに提供します。

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への自動化アクセスを求めます。一度許可してください。

• フルディスクアクセス。 保護された場所（例：~/Library/Mail）は、実行プロセスにフルディスクアクセスが付与されている場合のみ結果を返します（システム設定 → プライバシーとセキュリティ → フルディスクアクセス）。

ローカルでのテスト

各サーバーをMCP Inspectorで個別にクリックしてテスト：

npm run inspect -w @mcps/spotlight

ライセンス

MIT