Skip to main content
Glama
MCP Azure Documentation Server

MCP Azure Documentation Server

by martoc

License: MIT Python 3.12 MCP

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 articles directory from azure-docs

  • Docker support for portable deployment across projects

  • STDIO transport for seamless MCP client integration

Related MCP server: Azure Updates MCP Server

Quick Start

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:latest

Building Locally with Docker

# Build the Docker image (includes pre-indexed documentation)
make docker-build

# Test the server
make docker-run

Using uv (Local Development)

# Initialise the environment
make init

# Build the documentation index
make index

# Run the server
make run

Container 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

martoc/mcp-azure-documentation

Platforms

linux/amd64, linux/arm64

Base image

python:3.12-slim

Index

Pre-built at image build time from MicrosoftDocs/azure-docs main branch

# Pull the latest image
docker pull martoc/mcp-azure-documentation:latest

# Run the MCP server
docker run -i --rm martoc/mcp-azure-documentation:latest

Configuration

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_documentation

Search Azure documentation by keyword query with optional section filtering

read_documentation

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

query

string

Yes

-

Search terms (supports stemming)

section

string

No

None

Filter by section (Azure service/product directory)

limit

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

path

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 stats

Development

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 checker

Documentation

Licence

This project is licensed under the MIT Licence - see the LICENSE file for details.

Available Tools

2 tools
read_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

    A3.6/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tools follow the exact same verb_noun pattern with snake_case naming (read_documentation, search_documentation). The convention is consistent and predictable.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      3
      26 npm
      4
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to search and retrieve Azure service updates, retirements, and feature announcements using natural language queries with fast local caching.
      MIT