Unix Manual

An MCP server that provides Unix command documentation directly within LLMs conversations.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 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": {
    "tizee-mcp-unix-manual": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "dev",
        "unix_manual_server.py"
      ]
    }
  }
}

You can run the Unix Manual MCP Server to access UNIX command documentation directly within Claude conversations. It lets you fetch command help, view usage pages, list common commands, and verify command availability without leaving your chat flow.

How to use

Use an MCP-compatible client to interact with the Unix Manual MCP Server. You can request command documentation, browse available UNIX commands by function, and check whether a specific command exists along with its version information.

How to install

Prerequisites you need before installation are Python 3.13+ and an MCP-compatible client such as Claude Desktop.

Install steps your environment should follow are:

pip install -e .

# or
uv install -e .

Additional sections

Install and run the server locally or within your MCP client using the provided commands for development and testing.

To run a development instance for testing, use the MCP developer flow shown here.

# Development server start
mcp dev unix_manual_server.py

# Development run using the MCP runner
uv run mcp dev unix_manual_server.py

Security

The server is designed to prevent command injection by validating command names, executing commands without a shell, and applying execution timeouts. It focuses on retrieving documentation and does not execute arbitrary commands.

Logging

Logs are written to unix-manual-server.log in the same directory as the server script, making it easier to troubleshoot issues and monitor activity.