README.md•1.32 kB
# MacPilot CLI
MacPilot CLI is an open-source tool that enables Large Language Models (LLMs) to interact with macOS through the MCP (Model Control Protocol) protocol.
It provides a collection of system tools that allow AI assistants to perform various operations on macOS systems.
## Tool Documentation
- `getCursorPosition`
- `controlMouse`
- `pasteText`
- `captureScreen`
- `shell`
- `openApp`
- `listApps`
- `getWindowsInfo`
- `getWindowA11yInfo`
## Tools To Be Implemented
- [ ] Drag mouse
## Getting Started
1. You need a Mac computer with Apple Silicon running macOS 14.0 (Sonoma) or later
2. Download the binary file from the [Releases](https://github.com/huhu415/macPilotCli) section
3. Configure your MCP-compatible application (Cursor or Claude Desktop app) by adding the following configuration:
```json
{
"mcpServers": {
"macPilotCli": {
"command": "/path/to/downloaded/binary"
}
}
}
```
4. Grant the necessary **permissions (screen recording, accessibility)** to the application you're using with MacPilot CLI.
*For example, if you're using Cursor, make sure Cursor has the required permissions in System Settings.*
5. Switch to a tool-compatible model according to your application's requirements, and you're ready to use MacPilot CLI
