Aspire.MCP.Sample

Name: Aspire.MCP.Sample
Author: elbruno

@elbruno

Repository Homepage

About Aspire.MCP.Sample

Sample MCP Server and MCP client with Aspire

#mcp #aspire #azd

Basic information

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.