Aspire.MCP.Sample

What is Aspire.MCP.Sample?

Aspire.MCP.Sample is a sample project demonstrating a Model Context Protocol (MCP) server and client setup using Aspire, written in C#. It shows how to establish and manage MCP communication within a structured Aspire environment.

How to use Aspire.MCP.Sample?

Clone the repository, navigate to the Aspire project directory (src/McpSample.AppHost), and run dotnet run. In the Aspire Dashboard, open the Blazor Chat client, define the model (Azure AI Foundry, GitHub Models, or Ollama) in Chat Settings, then chat with the model to see function calls and tool results.

Features of Aspire.MCP.Sample

• Aspire integration for containerized orchestration and service management.
• MCP server to manage client communication.
• Blazor Chat MCP client for connecting and communicating.
• Supports Azure AI Foundry, Ollama, and GitHub Models.
• Function calling from the MCP server using the selected model.
• Displays tool result in the chat interface.
• Azure deployment via azd commands.

Use cases of Aspire.MCP.Sample

• Learn how to build an MCP server and client with Aspire.
• Experiment with MCP function calling using different LLMs.
• Deploy an MCP solution to Azure for cloud consumption.
• Use as a reference for integrating MCP into .NET Aspire projects.

FAQ from Aspire.MCP.Sample

What prerequisites are needed to run Aspire.MCP.Sample?

You need .NET SDK 9.0 or later, Visual Studio 2022 or Visual Studio Code, and an LLM/SLM that supports function calling (Azure AI Foundry, GitHub Models, or Ollama).

Which models are supported?

The sample supports models from Azure AI Foundry (e.g., gpt-4o-mini), GitHub Models (e.g., gpt-4o-mini), and Ollama (e.g., phi4-mini, llama3.2, or Qwq).

Can I deploy Aspire.MCP.Sample to Azure?

Yes, after opening the project locally or in Codespaces, run azd auth login then azd up to provision and deploy all resources to Azure. The deploy files are in ./src/McpSample.AppHost/infra/.

What runtime environment does the server require?

The sample is built with .NET 9.0 and uses Aspire for containerized orchestration. It can run locally with dotnet run or be deployed to Azure.

Does Aspire.MCP.Sample support authentication or special transports?

The README does not mention authentication or custom transports beyond standard Aspire service management and HTTP-based communication via the Blazor client.