macos-tools-mcp

FastMCP server that makes a handful of read-only macOS terminal utilities available to MCP clients.

Requirements

• macOS 12 or newer (tools require native system binaries)

• uv for dependency and virtual environment management

• Python 3.11 (automatically managed by uv via .python-version)

Getting started

1. Install dependencies and create the virtual environment:

   uv sync

2. Launch the MCP server:

   uv run macos-tools-mcp

   The FastMCP server starts with default settings and exposes the registered tools.

Available tools

• diskutil_list – lists disks and partitions by invoking diskutil list.

• battery_status – reports battery information from pmset -g batt.

• network_services – enumerates configured network services via networksetup.

• network_service_details – retrieves IP/subnet/router info for a given network service (for example Wi-Fi).

• system_profile – returns structured JSON from system_profiler; accepted aliases are software, hardware, network, and power.

Development notes

• Execute uv run python -m macos_tools_mcp.server to run the server module directly.

• The helper module macos_tools_mcp.tools centralizes command invocation and validation logic if you need to add more tools.