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
- Install dependencies and create the virtual environment:
uv sync - Launch the MCP server:
The FastMCP server starts with default settings and exposes the registered tools.uv run macos-tools-mcp
Available tools
diskutil_list– lists disks and partitions by invokingdiskutil list.battery_status– reports battery information frompmset -g batt.network_services– enumerates configured network services vianetworksetup.network_service_details– retrieves IP/subnet/router info for a given network service (for exampleWi-Fi).system_profile– returns structured JSON fromsystem_profiler; accepted aliases aresoftware,hardware,network, andpower.
Development notes
- Execute
uv run python -m macos_tools_mcp.serverto run the server module directly. - The helper module
macos_tools_mcp.toolscentralizes command invocation and validation logic if you need to add more tools.
