mcpField
M
mac-control

mac-control

github.com/aiagentwithdhruv生产力20114 次安装15 周前更新
代码仓库

关于 mac-control

mac-control 是一项通过自然语言请求控制 Mac 的技能，使用本地 macOS 命令。它涵盖应用、显示、音频、文件搜索、剪贴板、通知和截图操作，并包含命令安全限制。

主要功能

  1. 01启动、退出和切换应用
  2. 02切换深色模式并设置音量
  3. 03搜索文件并打开文件夹
  4. 04读取和写入剪贴板内容
  5. 05发送通知并播放声音
  6. 06截取屏幕或前台窗口

适用场景

  1. 01执行任务时切换应用
  2. 02用 Spotlight 查找文档
  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 自动化

通过 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易读的结果或错误消息
凭据
名称类型必填描述
（无）——无需凭据——使用本地 macOS 命令
可组合使用
  • ghost-browser — 截图 → 分析 → 自动化浏览器
  • google-mcp — 搜索文件 → 电子邮件附件
  • instantly-campaigns — 剪贴板 → 电子邮件模板
费用

免费——仅使用标准库，不调用 API。

安全

  • 屏蔽的关键词：rm、sudo、shutdown、format、erase、passwd、kill
  • 根据 /Applications/ 验证应用名称
  • 清理 AppleScript 字符串
  • 所有命令均设有 10s 超时
  • 不会在任何地方使用 shell=True

评论

支持 Markdown