用途 mcp-macos 是一个面向 AI Agent 的 MCP 服务器，用于观察和操作 macOS 系统。它把 Mac 上的文件、进程、应用、Shell、AppleScript 和 GUI 等能力封装为 MCP 工具，同时通过严格的分级权限模型控制风险。该项目属于 dockndevai 的 MCP 服务器套件，共用同一套治理模型。
主要能力 按能力分为三个层级。只读层：读取文件、列出进程和应用、截屏。读写层：写入文件、设置剪贴板、发送通知、打开项目。管理员层（需显式开启）：运行命令、运行 AppleScript、删除到废纸篓、结束进程、驱动 GUI。服务器启动时默认只读，更高权限的工具只有在提升模式后才会注册；每个高影响能力需要同时满足管理员模式和其独立开关，最危险的操作会要求人工批准每次调用。
使用方式 需要 macOS 与 Node ≥ 22。click 和 move_mouse 依赖 cliclick，可通过 brew install cliclick 安装。项目提供 docs/CLIENTS.md，内含 Claude Code、Cursor、Codex、VS Code、Windsurf 的配置片段；环境变量请参考 .env.example。安全模型由 src/security.ts 强制执行，详见 SECURITY.md。
macOS 权限 宿主进程（终端或 MCP 客户端）需要在“系统设置 → 隐私与安全性”中授予以下权限：录屏（用于 screenshot）、辅助功能（用于 type_text、key_press、click、move_mouse）、自动化（按应用逐个弹窗，用于 run_applescript 和应用控制）、文件和文件夹/完全磁盘访问（用于在默认沙箱之外读写）。首次需要时会提示授予；未授予的权限无法绕过。
适用场景与限制 适合需要让 Agent 在 Mac 上执行观察与受控操作的场景，尤其是希望默认只读、按需提权并保留人工审批环节的用例。限制包括：仅支持 macOS；依赖 Node 22 及以上；高风险能力需要手动开启多项开关并可能逐次人工批准；未授予相应 macOS 隐私权限时，相关工具无法工作。项目未提供关于收费、价格或平台以外的其他信息，暂未提供。
