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

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Native · 94/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Mcp
Install
Docker
Trust
Trust: Established
Entrypoint
docker run -i --rm ghcr.io/microsoft/mcp-dotnet-samples/markdown-to-html:latest
Universal CLI install command
npx tokrepo install 3c9abab3-608c-55c7-bcd3-0b752e51e9f9
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