MCP Azure Documentation Server
Click on "Deploy 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., "@MCP Azure Documentation Server Search Azure documentation for how to deploy a virtual machine"
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.
MCP Azure Documentation Server
An MCP (Model Context Protocol) server that provides search and retrieval tools for Azure documentation. This server enables AI assistants like Claude to search and read Azure documentation directly from the MicrosoftDocs/azure-docs repository.
Features
Full-text search using SQLite FTS5 with BM25 ranking and Porter stemming
Section filtering to narrow search results by Azure service or product (e.g.
azure-functions,storage,app-service)Sparse checkout for efficient cloning of only the
articlesdirectory from azure-docsDocker support for portable deployment across projects
STDIO transport for seamless MCP client integration
Related MCP server: Azure Updates MCP Server
Quick Start
Using the Container Image (Recommended)
The martoc/mcp-azure-documentation container image is published to Docker Hub with the documentation index pre-built. Available for linux/amd64 and linux/arm64.
# Pull and run the server
docker run -i --rm martoc/mcp-azure-documentation:latestBuilding Locally with Docker
# Build the Docker image (includes pre-indexed documentation)
make docker-build
# Test the server
make docker-runUsing uv (Local Development)
# Initialise the environment
make init
# Build the documentation index
make index
# Run the server
make runContainer Image
The martoc/mcp-azure-documentation container image is published to Docker Hub. It includes the pre-built documentation index so the server is ready to use immediately.
Property | Value |
Registry | Docker Hub |
Image |
|
Platforms |
|
Base image |
|
Index | Pre-built at image build time from |
# Pull the latest image
docker pull martoc/mcp-azure-documentation:latest
# Run the MCP server
docker run -i --rm martoc/mcp-azure-documentation:latestConfiguration
Claude Code / Claude Desktop
Add to your .mcp.json or global settings to use the published container image:
{
"mcpServers": {
"azure-documentation": {
"command": "docker",
"args": ["run", "-i", "--rm", "martoc/mcp-azure-documentation:latest"]
}
}
}For a locally built Docker image:
{
"mcpServers": {
"azure-documentation": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp-azure-documentation"]
}
}
}For local development without Docker:
{
"mcpServers": {
"azure-documentation": {
"command": "uv",
"args": ["run", "mcp-azure-documentation"],
"cwd": "/path/to/mcp-azure-documentation"
}
}
}MCP Tools
Tool | Description |
| Search Azure documentation by keyword query with optional section filtering |
| Retrieve the full content of a specific documentation page |
search_documentation
Search Azure documentation using full-text search with stemming support.
Parameter | Type | Required | Default | Description |
| string | Yes | - | Search terms (supports stemming) |
| string | No | None | Filter by section (Azure service/product directory) |
| integer | No | 10 | Maximum results (1-50) |
Common Sections: azure-functions, app-service, storage, virtual-machines, aks, azure-sql, cosmos-db, active-directory, azure-monitor
read_documentation
Retrieve the full content of a documentation page.
Parameter | Type | Required | Description |
| string | Yes | Relative path to document (from search results) |
CLI Commands
# Build/rebuild the documentation index
uv run azure-docs-index index
uv run azure-docs-index index --rebuild
uv run azure-docs-index index --branch main
# Show index statistics
uv run azure-docs-index statsDevelopment
make init # Initialise development environment
make build # Run full build (lint, typecheck, test)
make test # Run tests with coverage
make format # Format code
make lint # Run linter
make typecheck # Run type checkerDocumentation
USAGE.md - Detailed usage instructions
CODESTYLE.md - Code style guidelines
CLAUDE.md - Claude Code instructions
Licence
This project is licensed under the MIT Licence - see the LICENSE file for details.
Available Tools
2 toolsread_documentationA
Read the full content of a specific Azure documentation page.
Inputs: path (required). Returns: result
search_documentationB
Search Azure documentation by keyword query.
Inputs: query (required), limit, section. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one retrieves full page content for a specific document, while the other searches for relevant documents by keyword. There is no overlap or ambiguity between them.
Both tools follow the exact same verb_noun pattern with snake_case naming (read_documentation, search_documentation). The convention is consistent and predictable.
With only two tools, the surface feels thin for a documentation server. It covers the core lookup workflow, but a browse or list operation would make it feel less minimal and more complete.
Search and read form a complete loop for finding and consuming documentation. Minor gaps include lack of browsing, metadata retrieval, or version selection, but agents can work around these using search.
Maintenance
Related MCP Connectors
Versioned documentation registry and semantic search for AI tools and coding assistants.
Tailor Platform for AI assistants: search, list and read the platform documentation.
Access and search Branch's official API documentation directly within any AI agent or client.
Find, write, publish and check pages and API references in your DeveloperHub docs from an AI client
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI systems to perform full-text and semantic search operations over structured/unstructured data in Azure Cognitive Search, with capabilities for document indexing and management through natural language.326 npm4ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search and retrieve Azure service updates, retirements, and feature announcements using natural language queries with fast local caching.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search and retrieve Microsoft AutoGen documentation across versions with smart search and fallback.24 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, query, and manage Azure AI Search indexes using full-text, semantic, and vector search, alongside index and document operations.MIT