MCP .NET Samples

Clone the Microsoft MCP .NET Samples repository to get all four sample projects.

git clone https://github.com/microsoft/mcp-dotnet-samples.git
cd mcp-dotnet-samples

Each sample is in its own directory. Browse the available samples: AwesomeCopilot, MarkdownToHtml, OutlookEmail, and TodoList. Each directory contains its own README with specific setup instructions.

ls -la
# AwesomeCopilot/    - Fetches GitHub Copilot customization files
# MarkdownToHtml/    - Converts markdown to HTML
# OutlookEmail/      - Sends email via Outlook
# TodoList/          - CRUD to-do list management

Navigate to a sample directory and restore NuGet packages, then build. The samples use the ModelContextProtocol NuGet package.

cd AwesomeCopilot
dotnet restore
dotnet build

Start one of the sample MCP servers. The server will listen for MCP client connections via stdio or HTTP as configured in the sample.

dotnet run --project AwesomeCopilot/AwesomeCopilot.csproj

Add the built sample to your MCP client configuration. For stdio-based samples, point the command at the dotnet run invocation or the compiled binary.

{
  "mcpServers": {
    "dotnet-todo": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/mcp-dotnet-samples/TodoList/TodoList.csproj"]
    }
  }
}

Several samples offer Docker-based installation for easier deployment without requiring the .NET SDK on the client machine. Pull and run the Docker image as specified in each sample's README.

# Example for a Docker-based sample
docker pull mcr.microsoft.com/mcp-dotnet-samples/todolist:latest
docker run -i mcr.microsoft.com/mcp-dotnet-samples/todolist:latest