MCP101

mcp101

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "zhuoli-mcp101": {
      "command": "uv",
      "args": [
        "run",
        "macos-tools-mcp"
      ]
    }
  }
}

You run a FastMCP server that exposes a curated set of read-only macOS terminal utilities to MCP clients. This makes it easy to query system information, manage disks, and fetch hardware and network details from remote MCP clients in a secure, controlled way.

How to use

Install the server locally and start it to make the registered tools available to MCP clients. You interact with this server through MCP clients by invoking the exposed tools, which run their underlying macOS commands on your machine and return the results in a structured format.

How to install

Prerequisites you need before starting are installed dependencies and a local environment managed by uv.

uv sync
```, block ends

Then launch the MCP server so it exposes the registered tools to MCP clients.

uv run macos-tools-mcp

Notes and troubleshooting

If you need to run the server directly from the module for development purposes, you can execute the module with the runtime command shown in the development workflow.

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.