mcp-docs

Generic MCP server that exposes Markdown documentation to LLMs, enabling them to search and answer questions about any software documentation.

The server identity (name, instructions, category labels) is driven entirely by the docs/ directory — which is a separate repository cloned alongside this one.

Requirements

• Python 3.14+

• uv

Setup

1. Clone the documentation repository

The docs/ directory must exist before the server can start. Clone the documentation repository into it:

git clone <docs-repo-url> docs

2. Install dependencies

uv sync

docs/ directory structure

The server auto-discovers categories from subdirectories. The only required file is config.toml at the root of docs/.

docs/
├── config.toml          # required — project identity
├── <category>/
│   ├── <topic>.md
│   └── ...
└── <category>/
    └── ...

config.toml

[project]
name = "my-project"
instructions = """
System instructions for the LLM. Describe what this documentation covers
and how the model should use the available tools.
"""

[categories]
folder-name = "Human-readable label"

• [project] is required. name identifies the server; instructions guides the LLM.

• [categories] is optional. Any subdirectory not listed gets a title-cased label automatically (my-folder → My Folder).

• Files inside img/ subdirectories are never served.

Usage

Run the server (stdio mode)

uv run main.py

Development with MCP Inspector

uv run mcp dev main.py

Opens the MCP Inspector in the browser. To connect to a running SSE or Streamable HTTP server, start it first and point the inspector to the printed endpoint:

uv run main.py --transport sse
uv run main.py --transport streamable-http

Configure with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "my-project": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-docs", "run", "main.py"]
    }
  }
}

Configure with Claude Code

claude mcp add my-project -- uv --directory /path/to/mcp-docs run main.py

Capabilities

Tools

Resources