MCP Azure APIM Workshop

Table of Contents

• Documentation
• Workshop
  • 1. Configure Azure Resources
  • 2. Expose API as an MCP Server
  • 3. Setup Python environment
  • 4. Fastapi MCP Client (Python)
  • 5. Github Copilot MCP Tool (vscode)
  • 6. Custom Agent on Azure Ai Foundry (Python)
  • 7. MCP Policies in APIM (EntraID)
  • 8. Secure MCP MS Learn using EntraID and APIM
  • 9. MCP Registry for GitHub Copilot and VSCode

This workshop demonstrates how to use Azure API Management (APIM) to expose an existing REST API as a Model-Context-Protocol (MCP) Server. The MCP Server can then be consumed as a tool by various clients, including AI agents built with Azure AI services.

What you will learn in this workshop:

• deploy an Azure infrastructure with Azure Developer CLI (azd)
• expose a rest API on a MCP Server on an APIM
• call the MCP Server from different clients:
  • a python script using the fastmcp library
  • a python script using the azure-ai-agents library
• call the MCP Server through a GitHub Copilot MCP tool
• add a security layer on the MCP Server through APIM policies

The workshop leverages the public Setlist.fm API as an example. It provisions the necessary Azure infrastructure using Bicep and the Azure Developer CLI (azd). Setlist.fm is a collaborative online platform dedicated to documenting setlists—the lists of songs performed by artists or bands during concerts. Unlike official setlists, Setlist.fm focuses on what was actually played at live events.

Documentation

• https://learn.microsoft.com/en-us/azure/api-management/mcp-server-overview
• https://devblogs.microsoft.com/foundry/announcing-model-context-protocol-support-preview-in-azure-ai-foundry-agent-service/
• https://devblogs.microsoft.com/blog/connect-once-integrate-anywhere-with-mcps

Workshop

1. Configure Azure Resources

This project is using azd to configure the Azure Resources

azd auth login
azd up