shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

macPilotCli

MacPilot CLI是一个开源工具，通过MCP协议让大语言模型与macOS系统交互，提供系统操作功能。

article

README

🚀 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 了。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client