Sample MCP Server and MCP client with Aspire
Sample MCP Server and MCP client using Aspire.
This sample demonstrates a Model Context Protocol (MCP) Server and client setup using Aspire. It showcases how to establish and manage MCP communication, using C# in a structured Aspire environment.
Check out this 5-minute video overview to see the project in action.
Check out this 5-minute video overview to see how to deploy the solution to Azure, and how to consume the deployed MCP Server in Azure from Visual Studio Code.
azd
commands.Clone the repository:
Navigate to the Aspire project directory:
cd .\src\McpSample.AppHost\
Run the project:
dotnet run
In the Aspire Dashboard, navigate to the Blazor Chat client project.
In the Chat Settings page, define the model to be used. You choose to use models in Azure AI Foundry (suggested gpt-4o-mini), GitHub Models or locally with ollama (suggested llama3.2)
Now you can chat with the model. Everytime that one of the functions of the MCP server is called, the Tool Result
section will be displayed in the chat.
(WIP)
Once you've opened the project in Codespaces, or locally, you can deploy it to Azure.
From a Terminal window, open the folder with the clone of this repo and run the following commands.
Login to Azure:
azd auth login
Provision and deploy all the resources:
azd up
It will prompt you to provide an azd
environment name (like "aspiremcp"), select a subscription from your Azure account, and select a location.
When azd
has finished deploying, you'll see the list of resources created in Azure and a set of URIs in the command output.
Visit the blazorchat URI, and you should see the MCP Chat App! 🎉
Note: The deploy files are located in the ./src/McpSample.AppHost/infra/
folder. They are generated by the Aspire AppHost
project.
Contributions are welcome! Feel free to submit issues and pull requests.
This project is licensed under the MIT License.
No configuration available
Related projects feature coming soon
Will recommend related projects based on sub-categories