mkdocs-mcp-plugin

# MkDocs MCP Plugin 🔍 A comprehensive MCP (Model Context Protocol) server for MkDocs documentation that provides intelligent search, retrieval, and integration capabilities for AI agents. This plugin automatically detects MkDocs projects, launches the development server, and provides powerful tools for querying documentation. ## Features ### 🚀 Auto-Detection & Integration - Automatically detects `mkdocs.yml` or `mkdocs.yaml` in your project - Launches MkDocs development server alongside the MCP server - Seamless integration with existing MkDocs workflows ### 🔎 Advanced Search Capabilities - **Keyword Search**: Fast, accurate text-based search using Whoosh indexing - **Vector Search**: Semantic search using sentence transformers (`all-MiniLM-L6-v2`) - **Hybrid Search**: Combines both keyword and semantic search for optimal results - **Real-time Indexing**: Automatically indexes markdown files with full-text search ### 📄 Document Operations - Read individual markdown files with metadata extraction - List all available documentation with titles and paths - Extract headings, titles, and content structure - Support for nested directory structures ### 🤖 MCP Protocol Compliance - Full MCP server implementation using FastMCP - Tools, resources, and prompts for agent interaction - Structured responses with comprehensive error handling - Support for concurrent agent connections ## Installation ### Using UV/UVX (Recommended) Install and run directly with uvx: ```bash # Install and run in one command uvx mkdocs-mcp-plugin # Or install globally uv tool install mkdocs-mcp-plugin # Then run from any MkDocs project mkdocs-mcp ``` ### Using pip ```bash # Install from source pip install git+https://github.com/douinc/mkdocs-mcp-plugin.git # Or clone and install locally git clone https://github.com/douinc/mkdocs-mcp-plugin.git cd mkdocs-mcp-plugin pip install -e . ``` ### Development Installation ```bash git clone https://github.com/douinc/mkdocs-mcp-plugin.git c…