mcpField
M
mac-control

mac-control

github.com/aiagentwithdhruv生産性20114 回インストール15 週間前に更新
リポジトリ

mac-control について

mac-controlは、ローカルのmacOSコマンドを使い、自然言語のリクエストでMacを操作するスキルです。アプリや画面、音声、ファイル検索、クリップボード、通知、スクリーンショットを扱い、コマンドの安全対策も備えています。

主な機能

  1. 01アプリの起動・終了・切り替え
  2. 02ダークモードの切り替えと音量設定
  3. 03ファイル検索とフォルダー表示
  4. 04クリップボードの読み書き
  5. 05通知の送信とサウンド再生
  6. 06画面または前面ウィンドウの撮影

活用シーン

  1. 01作業中のアプリ切り替え
  2. 02Spotlightでのファイル検索
  3. 03テキストのクリップボードへのコピー
  4. 04ウィンドウのスクリーンショット撮影

MCP 対応

このスキルは `macos_mcp.py` MCPサーバーを使い、システム情報、アプリ操作、画面・音声設定、通知、ファイル検索、クリップボード、スクリーンショットのツールを提供します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aiagentwithdhruv/skills --skill mac-control

インストール後、Claude Code で/mac-controlを入力して読み込まれたか確認します。

詳細

macOS Control — AI Mac Automation

15 個の MCP ツールを使って、Claude から Mac を直接操作できます。アプリを開く、ダークモードを切り替える、ファイルを検索する、スクリーンショットを撮る、クリップボードを管理するなど、すべて自然言語で操作できます。

場所

プロジェクト： /Users/apple/Aiwithdhruv/AI Development/Claude/Mac-Automation/ MCP サーバー： Mac-Automation/macos_mcp.py

ツール一覧

システム（読み取り専用）
get_system_info()                    # macOS version, chip, RAM, uptime
get_running_apps()                   # All visible running apps
get_disk_usage()                     # Storage per volume
アプリの操作
open_app(app_name="Safari")          # Launch app (validated against /Applications/)
close_app(app_name="Notes")          # Graceful quit via AppleScript
switch_to_app(app_name="Terminal")   # Bring to foreground
ディスプレイとオーディオ
toggle_dark_mode()                   # Switch light <-> dark (instant visual)
set_volume(level=50)                 # 0-100, auto-unmutes
通知
send_notification(title="Hey", message="Class starting!", sound="Glass")
play_sound(sound_name="Ping")        # 14 system sounds available
ファイルと検索
spotlight_search(query="invoice.pdf", folder="~/Documents", limit=20)
open_folder(folder_path="~/Desktop") # Opens in Finder
クリップボード
get_clipboard()                      # Read current clipboard
set_clipboard(text="Hello World")    # Write to clipboard
スクリーンショット
take_screenshot(region="full")       # Saves PNG to Desktop
take_screenshot(region="window")     # Front window only

スキーマ

入力
名前型必須説明
app_namestr場合による.app を除いたアプリ名（例：'Safari'）
levelint場合による音量（0～100）
titlestr場合による通知のタイトル
messagestr場合による通知の本文
soundstrいいえサウンド名（default/Glass/Ping/Pop など）
querystr場合によるSpotlight の検索クエリ
folderstrいいえ検索対象のフォルダー
textstr場合によるクリップボードにコピーするテキスト
regionstrいいえスクリーンショットの範囲（full/window）
出力
名前型説明
resultstr人が読める形式の結果またはエラーメッセージ
認証情報
名前型必須説明
(none)——認証情報は不要です。ローカルの macOS コマンドを使用します
組み合わせ可能なツール
  • ghost-browser — スクリーンショット → 分析 → ブラウザーを自動化
  • google-mcp — ファイルを検索 → メールに添付
  • instantly-campaigns — クリップボード → メールテンプレート
コスト

無料 — 標準ライブラリのみを使用し、API 呼び出しはありません。

安全性

  • ブロック対象のキーワード：rm、sudo、shutdown、format、erase、passwd、kill
  • アプリ名は /Applications/ と照合して検証されます
  • AppleScript の文字列はサニタイズされます
  • すべてのコマンドに 10 秒のタイムアウトが設定されています
  • shell=True は一切使用しません

コメント

Markdown 対応