man-mcp-server

man-mcp-server

MCP to search and access man pages on the local machine.

9
Stars
1
Forks
0
Releases

Overview

This MCP server exposes Linux man pages as fast MCP resources, enabling AI assistants to search, retrieve, and explore system documentation directly on the local machine. It supports searching by keyword or command name via apropos, retrieving full man pages by name with optional section filtering, and listing available sections (1–9) with descriptions. Content is cleaned and formatted for AI consumption and the operations are asynchronous with timeout protection. Man pages are exposed as resources under man:// URIs (e.g., man://section/page, man://search/keyword, man://sections). The server runs on Linux with a standard man page setup, requires Python 3.10+, and depends on the MCP library (bundled in MCPB or installable via package managers). It can be used standalone, or packaged as an MCP Bundle (MCPB) for easy integration with IDEs like VS Code and Copilot, Claude Desktop, etc. The README also provides development and deployment guidance: quick start with MCPB, building bundles, and configuring clients via mcp.json or Python invocation.

Details

Owner
guyru
Language
Python
License
MIT License
Updated
2025-12-07

Features

Search man pages

Find documentation by keyword or command name using apropos.

Retrieve specific pages

Get complete man page content by name and optional section.

List sections

Browse available man page sections (1-9) with descriptions

Clean formatting

Man page content is cleaned and formatted for AI consumption

Async operations

All operations are asynchronous with timeout protection

MCP Resources

Expose man pages as resources with man:// URIs

Audience

AI assistantsEnable AI assistants to access Linux man pages via MCP during conversations.
DevelopersIntegrate local man page access into tools and IDEs via MCPB bundles.
IDE usersEnable Copilot in IDEs like VS Code or Claude Desktop to query man pages.

Tags

Linuxman pagesMCPMCPBAIsearchretrievesections 1-9asynchronoustimeoutsman:// URIsVS CodeClaude DesktopCopilotlocal documentation