Content
# powergentic/azd-mcp-csharp 
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.
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:
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
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).
