This project contains a .NET web app implementation of a Model Context Protocol (MCP) server. The application is designed to be deployed to Azure App Service.

The MCP server provides an API that follows the Model Context Protocol specification, allowing AI models to request additional context during inference.

• Complete implementation of the MCP protocol in C#/.NET using MCP csharp-sdk
• Azure App Service integration
• Custom tools support

• src/ - Contains the main C# project files
  • Program.cs - The entry point for the MCP server
  • Tools/ - Contains custom tools that can be used by models via the MCP protocol
    • MultiplicationTool.cs - Example tool that performs multiplication operations
    • TemperatureConverterTool.cs - Tool for converting between Celsius and Fahrenheit
    • WeatherTools.cs - Tools for retrieving weather forecasts and alerts
• infra/ - Contains Azure infrastructure as code using Bicep
  • main.bicep - Main infrastructure definition
  • resources.bicep - Resource definitions
  • main.parameters.json - Parameters for deployment

• Azure Developer CLI
• .NET 9 SDK
• For local development with VS Code:
  • Visual Studio Code
• MCP C# SDK:

  dotnet add package ModelContextProtocol --prerelease

1. Clone this repository
2. Navigate to the project directory

   cd src

3. Run the project:

   dotnet run

4. The MCP server will be available at https://localhost:5000
5. When you're done, press Ctrl+C in the terminal to stop the app

1. Add MCP Server from command palette and add the URL to your running server's HTTP endpoint:

   http://0.0.0.0:5000
   

2. List MCP Servers from command palette and start the server
3. In Copilot chat agent mode, enter a prompt to trigger the tool:

   Multiply 3423 and 5465
   

4. When prompted to run the tool, consent by clicking Continue

You can ask things like:

• What's the weather forecast in NYC?
• Are there any weather alerts in California?

1. In a new terminal window, install and run MCP Inspector:

   npx @modelcontextprotocol/inspector

2. CTRL+click the URL displayed by the app (e.g. http://0.0.0.0:5173/#resources)
3. Set the transport type to HTTP
4. Set the URL to your running server's HTTP endpoint and Connect:

   http://0.0.0.0:5000
   

5. List Tools, click on a tool, and Run Tool

1. Login to Azure:

   azd auth login

2. Initialize your environment:

   azd env new

3. Deploy the application:

   azd up

   This will:

   • Build the .NET application
   • Provision Azure resources defined in the Bicep templates
   • Deploy the application to Azure App Service

Use the web app's URL:

https://<webappname>.azurewebsites.net

Follow the same process as with the local app, but use your App Service URL:

https://<webappname>.azurewebsites.net

When you're done working with your app and related resources, you can use this command to delete the function app and its related resources from Azure and avoid incurring any further costs:

azd down

The project includes a sample tool in the Tools directory:

• MultiplicationTool.cs - A simple tool that demonstrates how to implement MCP tools

To add new tools:

1. Create a new class in the Tools directory
2. Implement the MCP tool interface
3. Register the tool in Program.cs