Mkdocs Mcp

An experimental MkDocs plugin that runs a local MCP server exposing a MkDocs project's documentation pages as resources for an assistant.

What you can do

• Serve the pages of a configured MkDocs project to the assistant as MCP resources.
• Name resources by source file, destination URL or page title, depending on the plugin's naming_style setting.
• Deliver page content as source Markdown by default, or as Markdown converted from the built HTML when prefer_markdown is disabled.
• Optionally aggregate all pages into one resource, or aggregate pages folder by folder.
• Build the site and launch the server through the mkdocs_mcp script, since mkdocs serve cannot be overridden.

When to use it

Useful when you keep documentation in a MkDocs project and want an assistant to read those pages directly while you write or edit them, instead of pasting content into the chat. It is a proof-of-concept, so it suits experimentation rather than production documentation workflows.

Requirements

Runs locally as a stdio process started with the mkdocs_mcp script (for example via uv run mkdocs-mcp -mt stdio). Needs a MkDocs project path, given with the --mkdocs-project-path option or the MKDOCS_PROJECT_PATH environment variable, and the mcp plugin added to the project's mkdocs.yml. The README uses uv for dependencies and virtual environments.