huhu415_macpilotcli

huhu415_macpilotcli

by huhu415
Enables Large Language Models to interact with macOS systems using the MCP protocol.

macOS System Control for LLMs via MCP

Overview

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.

Tools Documentation

Tool Name Description Input Parameters
repeat Echo back the input text text: String to repeat
getCursorPosition Returns the current mouse position and screen details None
moveCursor Moves the mouse cursor to specific coordinates x: X coordinate, y: Y coordinate
clickMouse Performs a mouse click at the current cursor position None
pasteText Copies text to clipboard and pastes it text: Text to paste
captureScreen Takes a screenshot of the entire screen None
executeCommand Runs a shell command and returns the output command: Command to execute, args: Optional arguments array
launchApp Launches an application bundleId & Application identifier or appName & Application name
getAppsList Returns a list of installed applications None
getWindowsList Returns information about all windows None
getFocusedWindowInfo Returns information about the focused window None
getWindowInfo Returns detailed information about a window pid: Optional process ID

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 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.

Resources

Languages

  • Swift 99.1%
  • Makefile 0.9%

Features & Capabilities

Categories
mcp_server model_context_protocol swift macos llm system_tools api_integration

Implementation Details

View on GitHub

Stats

0 Views
5 GitHub Stars

Repository Info

huhu415 Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI