{
  "markdown": "# mkdocs-mcp\n\n**MkDocs Plugin to Serve MCP**  \n*A proof-of-concept — feedback welcome!*\n\n---\n\n`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.\nInstead, this project provides the `mkdocs_mcp` script to handle the build process and launch the MCP server.\n\n## Quick Start\n\n### Requirements\n\nThis project uses [`uv`](https://github.com/astral-sh/uv) for dependency management and virtual environments.\n\n\n### Running the MCP Server\n\nTo start the MCP server:\n\n```bash\nuv run mkdocs-mcp -mt stdio\n```\n\nUse 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.\n\n\n### MkDocs Configuration\n\nMake sure to include `mcp` in your `mkdocs.yml` plugin list:\n\n```yaml\nplugins:\n  - mcp:\n      naming_style: src_file  # \"src_file\"(default), \"dst_url\" or \"title\"\n      prefer_markdown: True  # By default the source markdown is used, set to False to convert the output HTML to markdown\n      combine_all_pages: False  # Aggregate all pages into one file\n      combine_by_folder: False  # Aggregate each folder\n```\n\n## Using Claude Desktop with WSL\n\nIf you're working with Claude Desktop and WSL, configure your `claude_desktop_config.json` as follows (adjust paths as needed):\n\n```json\n{\n  \"mcpServers\": {\n    \"mkdocs\": {\n      \"command\": \"wsl.exe\",\n      \"args\": [\n        \"bash\",\n        \"-c\",\n        \"/home/urs/.cargo/bin/uv run --directory /home/urs/projects/mkdocs-mcp mkdocs-mcp -mt stdio\"\n      ]\n    }\n  }\n}\n```\n\n\n## Inspecting the MCP Server\n\nFor development and debugging, you can directly inspect the MCP server:\n\n```bash\nuv run mcp dev src/mkdocs_mcp/__main__.py\n```\n\n\n## Notes\n\n- This project is still in the **early proof-of-concept** stage.\n- Contributions and feedback are highly encouraged!\n\n---\n\nThanks for checking out `mkdocs-mcp`!\n\n---\n\nGitHub [MCP Registry](https://github.com/mcp) mcp-name: io.github.ubaumann/mkdocs-mcp\n",
  "bytes": 2106,
  "sha": "7e740b35621b9e15fd816490a5addec93ddbca6773e7ff805d9ab737c25e9ce1",
  "repo_slug": "ubaumann/mkdocs-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ubaumann_mkdocs_mcp_b68d8720/readme"
}