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.
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose targeting different macOS system components: battery, disks, network services (listing vs. details), and system profile. There is no overlap in functionality, making tool selection straightforward for an agent.
The naming follows a consistent snake_case pattern with descriptive names (e.g., battery_status, diskutil_list). However, there is a minor deviation with 'network_service_details' and 'network_services' using slightly different naming styles (details vs. services) compared to the others, though still readable.
With 5 tools, the count is well-scoped for a macOS system utilities server. Each tool serves a specific, non-trivial purpose (battery, disks, network, system info), and there are no redundant or missing tools that would make the set feel too thin or bloated.
The toolset covers key macOS system areas (battery, storage, network, hardware/software info), but there are notable gaps in common system operations like process management, file operations, or user management. While the provided tools are useful, the surface is incomplete for broader system administration tasks.