Documentation MCP Server
The Documentation MCP Server gives AI assistants structured access to documentation across Markdown and OpenAPI files, with both an MCP endpoint for AI clients and a web interface for browsing.
Full-text search (
search_documentation): Search with relevance scoring, optional category filtering, configurable result limits, and hierarchical breadcrumb context.Navigate documentation (
navigate_to): Navigate to a specific URI (e.g.,docs://guides/security) and retrieve parent, children, and breadcrumb context.Table of contents (
get_table_of_contents): Retrieve the complete documentation hierarchy as a tree, with an optional max depth parameter.Retrieve a document (
get_document): Fetch the full content and metadata for any document by its URI.Tag-based search (
search_by_tags): Find documents by metadata tags (OR logic) with optional category filtering and result limits.List all tags (
get_all_tags): Get all unique tags across documentation, with optional category filtering and document counts per tag.Generate PDF : Export all documentation as a PDF (requires optional PDF dependency).
Enables AI assistants to navigate and search documentation organized in markdown files, supporting hierarchical structures and YAML frontmatter for metadata extraction.
Provides support for parsing and querying documentation written in the MDX format, allowing assistants to access structured content and associated metadata.
Supports the loading and querying of OpenAPI 3.x specifications in YAML format and enables the extraction of document metadata from YAML frontmatter.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Documentation MCP Serversearch for the getting started guide and summarize the setup steps"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
your-docs-mcp
An MCP server that gives AI assistants structured access to your documentation. Supports markdown with YAML frontmatter, OpenAPI specs, full-text search, a web interface, and PDF generation.
Installation
Install from PyPI:
pip install your-docs-mcpWith semantic search (recommended):
pip install "your-docs-mcp[vector]" --extra-index-url https://download.pytorch.org/whl/cpuWith PDF generation:
pip install "your-docs-mcp[pdf]"All features:
pip install "your-docs-mcp[vector,pdf]" --extra-index-url https://download.pytorch.org/whl/cpuPDF generation requires system packages:
macOS:
brew install pandoc basictexUbuntu/Debian:
sudo apt install pandoc texlive-xetex texlive-latex-extra
Quick Start
export DOCS_ROOT=/path/to/your/docs
your-docs-serverOpen http://localhost:8123 to browse your docs. The MCP server is also running for AI clients.
AI Client Setup
Claude Desktop - edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"docs": {
"command": "your-docs-mcp",
"env": {
"DOCS_ROOT": "/absolute/path/to/your/docs"
}
}
}
}VS Code - create .vscode/mcp.json:
{
"servers": {
"docs": {
"command": "your-docs-mcp",
"env": {
"DOCS_ROOT": "${workspaceFolder}/docs"
}
}
}
}Available MCP Tools
Tool | Description |
| Full-text search with relevance scoring |
| Navigate to a doc by URI (e.g. |
| Get the full documentation hierarchy |
| Retrieve a document and its metadata |
| Filter docs by tags |
| List all tags across documentation |
| Generate a PDF of all documentation |
Supported Formats
Markdown with YAML frontmatter:
---
title: Getting Started
tags: [guide, quickstart]
order: 1
---
# Getting Started
Your content here...OpenAPI 3.x (.yaml or .json) is also supported.
Configuration
Key environment variables:
DOCS_ROOT=/path/to/docs # Required: documentation root directory
MCP_DOCS_CACHE_TTL=3600 # Cache TTL in seconds
MCP_DOCS_SEARCH_LIMIT=10 # Max search results
MCP_DOCS_WEB_PORT=8123 # Web server port
LOG_LEVEL=INFO # DEBUG, INFO, WARNING, ERRORRunning Modes
your-docs-server # MCP server + web interface
your-docs-mcp # MCP server only
your-docs-web # Web interface onlyDevelopment
git clone https://github.com/esola-thomas/your-docs-mcp
cd your-docs-mcp
pip install -e ".[dev,vector,pdf]" --extra-index-url https://download.pytorch.org/whl/cpu
pytest
ruff check .Contributing
See the contributing guide for details on running tests, code style, and submitting pull requests. Open an issue to report bugs or request features.
License
MIT - see LICENSE for details.
Links
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/esola-thomas/your-docs-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server