Unix Manual Server (MCP)

Name: Unix Manual Server (MCP)
Author: tizee

@tizee

Repository

About Unix Manual Server (MCP)

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

#mcp #unix-manual #model-context-protocol-servers

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-unix-manual": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "install",
        "unix_manual_server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Unix Manual Server (MCP)?

An MCP server that provides Unix command documentation directly within Claude conversations. It retrieves help pages, man pages, and usage information for Unix commands, lists available commands categorized by function, and checks if a specific command exists along with its version.

How to use Unix Manual Server (MCP)?

Install Python 3.13+, clone the repository, and run pip install -e . or uv install -e .. Then install the server in Claude Desktop with mcp install unix_manual_server.py. After installation, ask Claude for documentation (e.g., "I need help with the grep command"), list commands ("What Unix commands are available?"), or check existence ("Is the awk command available?").

Key features of Unix Manual Server (MCP)

Retrieve man pages, help, and usage info for Unix commands
List available commands on your system, categorized by function
Verify if a specific command exists and get its version
Validates command names against a regex pattern to prevent injection
Executes commands directly without using a shell
Sets timeouts on all command executions for safety

Use cases of Unix Manual Server (MCP)

Quickly get the documentation for a specific Unix command without leaving a conversation
Discover what commands are available on your system, grouped by category
Check whether a command is installed and what version it is
Learn about unfamiliar commands in a natural language chat interface

FAQ from Unix Manual Server (MCP)

What are the prerequisites for using Unix Manual Server (MCP)?

Python 3.13 or later and Claude Desktop (or any MCP‑compatible client) are required.

How does the server prevent command injection?

It validates command names against a regex pattern, executes commands directly without a shell, and sets timeouts on all executions. It only checks for documentation, never runs arbitrary commands.

Where does the documentation come from?

The server uses the local system’s man pages and command information — no external data sources are involved.

How do I install the server for development or testing?

Clone the repository, install the package (pip install -e . or uv install -e .), then use mcp dev unix_manual_server.py to test locally without installing in Claude Desktop.

Does the server produce any logs?

Yes, logs are saved to unix-manual-server.log in the same directory as the script, which is useful for debugging.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K