MCP ConfigsMay 13, 2026·2 min read

mcp-dotnet-samples — MCP Servers in .NET (Docker)

Microsoft’s MCP .NET samples show how to build MCP servers/clients in C#. Includes Docker-run demos like markdown-to-html and todo-list for quick testing.

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
Mcp Config
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Safe staging command
npx -y tokrepo@latest install 3c9abab3-608c-55c7-bcd3-0b752e51e9f9 --target codex

Stages files first; activation requires review of the staged README and plan.

Intro

Microsoft’s MCP .NET samples show how to build MCP servers/clients in C#. Includes Docker-run demos like markdown-to-html and todo-list for quick testing.

Best for: C#/.NET teams building MCP servers or learning patterns fast

Works with: Docker, Visual Studio / VS Code, MCP-compatible clients

Setup time: 3-10 minutes

Key facts (verified)

  • GitHub: 183 stars · 55 forks · pushed 2026-05-13.
  • License: MIT · owner avatar + repo URL verified via GitHub API.
  • README-verified entrypoint: docker run -i --rm ghcr.io/microsoft/mcp-dotnet-samples/markdown-to-html:latest.

Main

  • Start with the Docker images when you only need a working MCP server quickly; then open the sample directory to see the implementation patterns in .NET.

  • Treat the repo as a reference library: pick one sample (markdown-to-html, outlook-email, todo-list) and mirror its transport + tool shape in your own server.

  • Use the repo’s descriptions to decide integration scope: some samples are pure transformations (markdown→HTML) while others touch external services (Outlook).

Source-backed notes

  • README frames MCP as a standardized connection layer (“USB‑C port for AI applications”).
  • The sample table includes install links that embed Docker args for images like ghcr.io/microsoft/mcp-dotnet-samples/markdown-to-html:latest and .../todo-list:latest.
  • README points to MCP official docs and the MCP GitHub repository for deeper protocol details.

FAQ

  • Do I need .NET to try it?: Not necessarily — README’s install links include Docker-run servers you can start without building locally.
  • Which sample should I start with?: Pick markdown-to-html for a self-contained transformation, then move to service-backed ones like Outlook Email.
  • Is this only for Visual Studio?: No — README provides install links for VS Code and mentions using the samples in .NET apps broadly.
🙏

Source & Thanks

Source: https://github.com/microsoft/mcp-dotnet-samples > License: MIT > GitHub stars: 183 · forks: 55

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets