---
slug: "azd"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/powergentic/azd-mcp-csharp@main/README.md"
repo: "https://github.com/powergentic/azd-mcp-csharp"
source_file: "README.md"
branch: "main"
---
# powergentic/azd-mcp-csharp ![Awesome Badge](https://awesome.re/badge-flat2.svg)

An Azure Developer CLI (`azd`) template to deploy a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server written in C# to Azure Container Apps using SSE Transport.

## Prerequisites

To deploy this template you will need to have the following installed:

- [Azure Developer CLI](https://learn.microsoft.com/azure/developer/azure-developer-cli/overview)
- [Docker](https://www.docker.com/)

## Deployment

To use this template, follow these steps using the [Azure Developer CLI](https://learn.microsoft.com/azure/developer/azure-developer-cli/overview):

1. Log in to Azure Developer CLI. This is only required once per-install.

    ```bash
    azd auth login
    ```

2. Initialize this template using `azd init`:

    ```bash
    azd init --template powergentic/azd-mcp-csharp
    ```

3. Ensure Docker Engine is running on your machine. This will be needed by `azd` to build the Docker image for the app prior to deployment to Azure Container Apps.

4. Use `azd up` to provision your Azure infrastructure and deploy the web application to Azure.

    ```bash
    azd up
    ```

5. Once the template has finished provisioning all resources, and Azure Container Apps has completed deploying the app container _(this can take a minute or so after `azd up` completes to finish)_, the MCP server will be running.

    ![Screenshot AZD UP completed successfully](https://github.com/powergentic/azd-mcp-csharp/raw/HEAD/assets/screenshot-azd-up-completed.png)

6. To verify the MCP server is running, navigate your browser to the `/sse` url for the app within your browser.

    Example URL:

    ```text
    https://ca-mcp-vnv7lqmg46722.bravebeach-29a82758.eastus2.azurecontainerapps.io/sse
    ```

    This will open a streaming output within the browser that will look similar to the following:

    ![Screenshot of /sse endpoint on the MCP server](https://github.com/powergentic/azd-mcp-csharp/raw/HEAD/assets/screenshot-sse-endpoint.png)

7. **Congratulations**, you now have a simple MCP Server written in C# up and running in Azure! You can now customize this app to build the specific MCP server you need for your AI solution.

## Architecture Diagram

![Diagram of Azure Resources provisioned with this template](https://github.com/powergentic/azd-mcp-csharp/raw/HEAD/assets/architecture.png)

In addition to deploying Azure Resources to host the MCP server, this template includes a `DOCKERFILE` that builds the MCP server app with C#.

## Azure Resources

These are the Azure resources that are deployed with this template:

- **Container Apps Environment** - The environment for hosting the Container App
- **Container App** - The hosting for the MCP server app
- **Log Analytics** and **Application Insights** - Logging for the Container Apps Environment
- **Container Registry** - Used to deploy the custom Docker container for the app

## Author

This `azd` template was written by [Chris Pietschmann](https://pietschsoft.com), founder of [Powergentic.ai](https://powergentic.ai), Microsoft MVP, HashiCorp Ambassador, and Microsoft Certified Trainer (MCT).