<!-- mcp-name: io.github.rhel-lightspeed/unix-mcp-server -->
[![CI](https://github.com/rhel-lightspeed/unix-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/rhel-lightspeed/unix-mcp-server/actions/workflows/ci.yml)
[![Coverage](https://codecov.io/gh/rhel-lightspeed/unix-mcp-server/graph/badge.svg?token=TtUkG1y0rx)](https://codecov.io/gh/rhel-lightspeed/unix-mcp-server)
[![PyPI](https://img.shields.io/pypi/v/unix-mcp-server?label=PyPI)](https://pypi.org/project/unix-mcp-server)
[![Docs](https://img.shields.io/badge/Docs-Unix%20MCP%20Server-red)](https://rhel-lightspeed.github.io/unix-mcp-server/)


# Unix MCP Server

A Model Context Protocol (MCP) server for read-only Unix-like system administration, diagnostics, and troubleshooting.

This project is a fork of the [RHEL Lightspeed Linux MCP Server](https://github.com/rhel-lightspeed/linux-mcp-server), extended with macOS diagnostics and native macOS tooling support.


## Features

- **Read-Only Operations**: All tools are strictly read-only for safe diagnostics
- **Remote SSH Execution**: Execute commands on remote systems via SSH with key-based authentication
- **Multi-Host Management**: Connect to different remote hosts in the same session
- **Comprehensive Diagnostics**: System info, services, processes, logs, network, storage, and macOS-specific power/security diagnostics
- **Configurable Log Access**: Control which log files can be accessed via environment variables
- **Native Platform Support**: Uses systemd/journald on Linux and launchd/unified logging on macOS


## Installation and Usage

For detailed instructions on setting up and using the Unix MCP Server, please refer to our official documentation:

- **[Installation Guide]**: Detailed steps for `pip`, `uv`, and container-based deployments.
- **[Client Configuration]**: MCP client setup examples.
- **[Troubleshooting]**: Solutions for common issues.


[Installation Guide]: https://rhel-lightspeed.github.io/unix-mcp-server/install/
[Client Configuration]: https://rhel-lightspeed.github.io/unix-mcp-server/clients/
[Troubleshooting]: https://rhel-lightspeed.github.io/unix-mcp-server/troubleshooting/