🚀 MacPilot CLI 工具文档

MacPilot CLI 是一款开源工具，借助 MCP（模型控制协议）协议，能让大型语言模型 (LLMs) 与 macOS 系统进行交互。它提供了一系列系统工具，助力 AI 助手在 macOS 系统上开展各类操作。

✨ 主要特性

已实现的工具

• getCursorPosition - 获取鼠标光标位置
• controlMouse - 控制鼠标
• pasteText - 粘贴文本
• captureScreen - 捕捉屏幕
• shell - 执行 shell 命令
• openApp - 打开应用程序
• listApps - 列出所有应用程序
• getWindowsInfo - 获取窗口信息
• getWindowA11yInfo - 获取窗口可访问性信息

待实现的工具

• [ ] 拖动鼠标

📦 安装指南

入门步骤

1. 准备一台配备 Apple Silicon 的 Mac 电脑，系统需为 macOS 14.0 (Sonoma) 或更高版本。
2. 从 发布页面 下载二进制文件。
3. 配置你的 MCP 兼容应用（如 Cursor 或 Claude Desktop 应用），在配置文件中添加以下内容：

{
    "mcpServers": {
        "macPilotCli": {
            "command": "/path/to/downloaded/binary"
        }
    }
}

4. 授予你正在使用的应用必要的权限（屏幕录制、辅助功能）。例如，若使用 Cursor，需在系统设置中为其授予相关权限。
5. 根据应用需求切换到兼容的工具模型，即可开始使用 MacPilot CLI。