Mkdocs MCP

MkDocs Plugin to Serve MCP A proof-of-concept - feedback welcome! mkdocs-mcp is an experimental plugin designed to integrate an MCP server into the MkDocs workflow. Due to limitations in MkDocs, the native mkdocs serve command cannot be overridden. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2025-09-20 · ★ 9 · #635 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Mkdocs MCP

Claude Code

claude mcp add ubaumann-mkdocs-mcp -- uvx mkdocs-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ubaumann-mkdocs-mcp": {
      "command": "uvx",
      "args": [
        "mkdocs-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package mkdocs-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.ubaumann is GitHub-verified and matches the repo owner

03 · What Mkdocs MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Limitations (from the README)

- This project is still in the early proof-of-concept stage. - Contributions and feedback are highly encouraged! Thanks for checking out mkdocs-mcp!

Latest releases

v0.1.3 · 2025-09-20

Use the --mkdocs-project-path option to specify the path to your MkDocs project if it's not in the current directory. The environment variable MKDOCS_PROJECT_PATH can also be set for this purpose.

v0.1.2 · 2025-04-27

Add combine_all_pages option · Add combine_by_folder option

v0.1.1 · 2025-04-24

Added "naming_style" option allowing control of the resource name. · Support for rendering HTML to markdown.

04 · Who maintains Mkdocs MCP

mkdocs-mcp is maintained by ubaumann. It's the only MCP server we track from this author; the repo dates to Apr 2025.

05 · Facts

repository: github.com/ubaumann/mkdocs-mcp
category: other - ranked #635 of 848 actively-maintained other servers as of 2026-08-25.
registry: io.github.ubaumann/mkdocs-mcp (active, first published 2025-09-20)
packages: pypi:mkdocs-mcp

06 · Mkdocs MCP FAQ

What is Mkdocs MCP?

Is Mkdocs MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2025-09-20. We re-verify nightly.

How do I install Mkdocs MCP?

Run `uvx mkdocs-mcp`. You can also paste the ready-made client config above.

Does Mkdocs MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Mkdocs MCP

Alternatives to Mkdocs MCP

Maintained other servers if Mkdocs MCP isn't the fit.

More MCP servers to compare · Hilan MCP · Ui5 MCP Server · Webcomponents MCP Server · MaStR MCP Server · Unclaimed Sol

More Python MCP servers · Lachesis · Reclaim MCP Server · Silicon Friendly · Microsoft Access Database · see all