{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_d2qmw57rp47j","handle":"mkdocs-mcp-plugin","url":"https://wellknown.network/agents/mkdocs-mcp-plugin","links":{"self":"https://wellknown.network/agents/mkdocs-mcp-plugin/record.json","html":"https://wellknown.network/agents/mkdocs-mcp-plugin","markdown":"https://wellknown.network/agents/mkdocs-mcp-plugin/record.md","api":"https://wellknown.network/api/v1/agents/mkdocs-mcp-plugin","status":"https://wellknown.network/api/v1/agents/mkdocs-mcp-plugin/status","claim":"https://wellknown.network/agents/mkdocs-mcp-plugin/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mkdocs-mcp-plugin/claim.json","badge":"https://wellknown.network/agents/mkdocs-mcp-plugin/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mkdocs-mcp-plugin/history","tools":"https://wellknown.network/api/v1/agents/mkdocs-mcp-plugin/tools"},"ard":{"identifier":"urn:air::server:mkdocs-mcp-plugin","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mkdocs-mcp-plugin","summary":"MCP server for MkDocs documentation with intelligent search and retrieval capabilities","description":"# MkDocs MCP Plugin 🔍\n\nA 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.\n\n## Features\n\n### 🚀 Auto-Detection & Integration\n- Automatically detects `mkdocs.yml` or `mkdocs.yaml` in your project\n- Launches MkDocs development server alongside the MCP server\n- Seamless integration with existing MkDocs workflows\n\n### 🔎 Advanced Search Capabilities\n- **Keyword Search**: Fast, accurate text-based search using Whoosh indexing\n- **Vector Search**: Semantic search using sentence transformers (`all-MiniLM-L6-v2`)\n- **Hybrid Search**: Combines both keyword and semantic search for optimal results\n- **Real-time Indexing**: Automatically indexes markdown files with full-text search\n\n### 📄 Document Operations\n- Read individual markdown files with metadata extraction\n- List all available documentation with titles and paths\n- Extract headings, titles, and content structure\n- Support for nested directory structures\n\n### 🤖 MCP Protocol Compliance\n- Full MCP server implementation using FastMCP\n- Tools, resources, and prompts for agent interaction\n- Structured responses with comprehensive error handling\n- Support for concurrent agent connections\n\n## Installation\n\n### Using UV/UVX (Recommended)\n\nInstall and run directly with uvx:\n\n```bash\n# Install and run in one command\nuvx mkdocs-mcp-plugin\n\n# Or install globally\nuv tool install mkdocs-mcp-plugin\n\n# Then run from any MkDocs project\nmkdocs-mcp\n```\n\n### Using pip\n\n```bash\n# Install from source\npip install git+https://github.com/douinc/mkdocs-mcp-plugin.git\n\n# Or clone and install locally\ngit clone https://github.com/douinc/mkdocs-mcp-plugin.git\ncd mkdocs-mcp-plugin\npip install -e .\n```\n\n### Development Installation\n\n```bash\ngit clone https://github.com/douinc/mkdocs-mcp-plugin.git\nc…","publisher":null,"homepage":"https://github.com/dongookson/mkdocs-mcp-plugin#readme","repository":"https://github.com/dongookson/mkdocs-mcp-plugin#readme","version":"0.4.1","license":"MIT","protocols":["mcp"],"tags":["ai","documentation","mcp","mkdocs","rag","search"],"pricing":null,"endpoints":[{"url":"pypi:mkdocs-mcp-plugin","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"code.documentation","name":"Code Documentation","confidence":1,"provenance":"declared"},{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["code","data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mkdocs-mcp-plugin","registry":"pypi","observedAt":"2026-11-03T18:22:57.655Z","publishedAt":"2025-08-12T05:42:58.894433Z","latestVersion":"0.4.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mkdocs-mcp-plugin","url":"https://pypi.org/project/mkdocs-mcp-plugin/","firstSeenAt":"2026-09-10T06:23:22.224Z","fetchedAt":"2026-11-03T18:21:34.300Z","normalizedAt":"2026-11-03T18:21:34.300Z"}]},"firstSeenAt":"2026-09-10T06:23:22.224Z","updatedAt":"2026-11-03T18:22:57.655Z"}