macPilotCli

🚀 MacPilot CLI 工具文档

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

✨ 主要特性

已实现的工具

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

待实现的工具

• [ ] 拖动鼠标

📦 安装指南

环境要求

你需要一台配备 Apple Silicon 的 Mac 电脑，运行 macOS 14.0 (Sonoma) 或更高版本。

下载二进制文件

从 发布页面 下载二进制文件。

配置 MCP 兼容应用

配置你的 MCP 兼容应用（如 Cursor 或 Claude Desktop 应用），在配置文件中添加以下内容：

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

授予应用权限

授予你正在使用的应用必要的权限（屏幕录制、辅助功能）。例如，如果你使用的是 Cursor，请确保在系统设置中为 Cursor 授予相关权限。

切换工具模型

根据你的应用需求切换到兼容的工具模型，现在你就可以开始使用 MacPilot CLI 了。