A MCP server which loads the man pages of tools in $PATH as resource. The goal is to provide the LLM with context of the commands on the host machine
Overview
what is local-manpage-mcp-server?
local-manpage-mcp-server is an MCP server that extracts and exposes the man pages of all executables in your $PATH as MCP resources, providing LLMs with direct access to up-to-date documentation for commands installed on the host system.
how to use local-manpage-mcp-server?
To use the server, clone the repository, set up a Python virtual environment, install the required packages, and run the server. You must also execute the create_all_manpage_files tool to generate the MCP resources based on your system's commands.
key features of local-manpage-mcp-server?
- Extracts and serves man pages as MCP resources.
- Provides a self-explanatory server for LLMs to describe workflows automatically.
- Supports Linux distributions exclusively.
use cases of local-manpage-mcp-server?
- Enabling LLMs to access command documentation dynamically.
- Assisting developers in understanding command usage without leaving their development environment.
- Automating command explanations in applications.
FAQ from local-manpage-mcp-server?
- Is this server compatible with macOS or Windows?
No, it is designed exclusively for Linux distributions.
- What permissions are required to run this server?
You need read access to all directories in your $PATH and write permissions for a local manpages folder.
- Can I generate man pages for a large number of binaries?
Yes, but be aware that it can be CPU- and disk-intensive.