Keep Mac Awake

Keep Mac Awake MCP サーバー

この MCP サーバーを使うと、AI エージェントは、セッション中に Apple シリコン搭載の MacBook を蓋を閉じた状態でもスリープさせない macOS アプリ、Keep Mac Awake を利用できます。別途インストールが必要な有料アプリですが、無料トライアルがあります（keepmacawake.com）。このアプリを使うと、エージェントは長時間の作業を始める前に時間制限付きセッションを開始し、作業が終わったら停止できます。また、AC 電源やトライアル終了後の購入など、アプリがあなたに何かを求めているときは知らせます。エージェントにこの機能が必要な理由は、MacBook は蓋を閉じるとスリープし、それに伴ってエージェントの作業も停止するためです（蓋を閉じた状態で AI エージェントを実行し続ける）。

ローカル MCP サーバーを実行できるアプリ（Claude Desktop、Claude Code、Codex、Cursor、VS Code、Windsurf など）で動作します。エージェントがプラグインに対応している場合は、Keep Mac Awake プラグインでも同じことができ、スキルとセッション開始フックが追加されます。

ツール

ツール	機能
keep_awake_status	セッションが実行中かどうかと残り時間、無料トライアル、新しいバージョンのアプリを確認します。読み取り専用です。
keep_awake_start	1～168 時間の範囲で時間を指定してセッションを開始するか、時間制限なしで開始します。
keep_awake_stop	セッションを終了し、通常のスリープ設定に戻します。

エージェントは時間制限付きセッションを自動で開始し、その旨を一文で知らせます。時間制限なしのセッションを開始するときと、無料トライアルが始まる Mac での初回セッションの前には、まずあなたに確認します。エージェントが user_agreed を渡すまで、keep_awake_start はどちらの場合も開始を拒否します。実行中のセッションに重ねて別のセッションを開始することはありません。バッテリーの使用、購入、インストールは、メニューバーのパネルまたはターミナルから、あなた自身が行います。

インストール

Node.js 20 以降と Keep Mac Awake アプリが必要です（Apple シリコン搭載の Mac で、macOS 26 以降が必要です）。

Claude Code：

claude mcp add keepmacawake -- npx -y keepmacawake-mcp

Codex：

codex mcp add keepmacawake -- npx -y keepmacawake-mcp

Claude Desktop、Cursor および JSON 設定に対応するその他のアプリ（claude_desktop_config.json、.cursor/mcp.json）：

{
  "mcpServers": {
    "keepmacawake": {
      "command": "npx",
      "args": ["-y", "keepmacawake-mcp"]
    }
  }
}

このサーバーは npm パッケージ keepmacawake-mcp で、公式 MCP Registry には com.keepmacawake/mcp として登録されています。

アプリが npx が見つからないと報告する場合は、たとえば /opt/homebrew/bin/npx のように、フルパスを指定してください。

npm の代わりに、このリポジトリをクローンして使用する場合：

git clone https://github.com/bartdudzic/keepmacawake
cd keepmacawake/mcp && npm ci --omit=dev
claude mcp add keepmacawake -- node "$PWD/bin/keepmacawake-mcp.mjs"

使用例

• 「テストスイート全体を実行して、失敗したものを修正してください。蓋を閉じるので、あとでスマートフォンから確認します。」
• 「このマイグレーションの実行中、次の 2 時間は Mac をスリープさせないでください。」
• 「Keep Mac Awake は有効ですか？残り時間はどれくらいですか？」

実行内容

• 各ツールは、この Mac 上でアプリの keepmacawake コマンド（status、start、stop のいずれかと --json）を 1 回実行します。実行場所は、インストーラーが配置する /usr/local/bin または PATH です。別のパスを使う場合は KEEPMACAWAKE_CLI を設定してください。
• それ以外のものは一切実行しません。インストーラー、スクリプト、sudo、設定変更、支払いは実行しません。
• コマンドが通信するのは、この Mac 上のアプリのバックグラウンドサービスだけです。サーバーはネットワーク接続を開かず、テレメトリーもありません。
• サーバーが Mac 自体で実行されている場合にのみ動作します。クラウドコンテナなど、別の場所では、どのツールも「Keep Mac Awake にアクセスできません」と応答します。

プライバシー

サーバーが外部に何かを送信することはありません。サーバーの結果はエージェントとの会話の一部となるため、エージェントのプロバイダーには、セッションが実行中かどうか、残り時間、トライアルの残り時間、バッテリー設定、新しいバージョンの情報が渡ります。アプリからの応答について、サーバーが引き継ぐのはこれらのフィールドだけです。この Mac の ID、購入の詳細、アプリ独自のメッセージは渡しません。ただし、セッション開始を拒否したときにアプリが示す簡潔な理由は除きます。アプリ自体のデータ利用については、プライバシーに関する説明をご覧ください。

トラブルシューティング

• 「Keep Mac Awake がインストールされていません」： keepmacawake.com からアプリをインストールするか、コマンドの場所が異なる場合は KEEPMACAWAKE_CLI を設定してください。
• 「バックグラウンドサービスから応答がありません」：アプリケーションから Keep Mac Awake を開いてください。サンドボックス内でサーバーを実行する MCP ホストでは、サービスへの接続がブロックされる場合があります。
• バッテリー駆動時にセッションが拒否される場合：AC 電源に接続するか、メニューバーのパネルでバッテリー駆動での使用を許可してください。

開発

npm ci
npm test

テストでは偽の keepmacawake コマンドを使用し、実際のセッションには一切触れません。

サポート

[email protected] までご連絡ください。セキュリティ上の問題については、SECURITY.md をご覧ください。Keep Mac Awake は Apple と提携していません。

ライセンス

サーバーは MIT License の下で提供されています。サーバーが制御する Keep Mac Awake アプリは対象外です。無料トライアル後に購入する場合は、アプリ独自の利用規約が適用されます。