macOS Tools MCP Server

# 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](https://docs.astral.sh/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: ```bash uv sync ``` 2. Launch the MCP server: ```bash 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.