MCP .NET Samples
Ready MCP servers on .NET from Microsoft: Copilot files, Markdown to HTML, Outlook mail and a to-do list
- 201 ★ on the repository
- Last commit
Extended access
Why this level
- The outlook-email server sends mail as you
- Images run in Docker with network access
Install
- Works in
Manual install
docker run -i --rm ghcr.io/microsoft/mcp-dotnet-samples/markdown-to-html:latestRuns one of the samples; the image name changes for the others.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The outlook-email server sends mail as you
- Images run in Docker with network access
This is third-party code. Review the repository files before installing.
What it does
The Microsoft repository gathers four working MCP server samples on .NET. `awesome-copilot` finds and serves GitHub Copilot customization files from the awesome-copilot catalog. `markdown-to-html` turns Markdown text into HTML. `outlook-email` sends mail through Outlook. `todo-list` manages a to-do list. Each sample has a Docker image in the `ghcr.io/microsoft/mcp-dotnet-samples` registry, install buttons for VS Code and Visual Studio and its own folder with a description. The samples show how to write your own MCP server on .NET and how to connect it to Azure services. Run them as they are with `docker run -i --rm` and then use them as a base for your own server. Every folder holds source code, a Dockerfile and its own instructions.
Who it is for. .NET developers writing their own MCP server who want a Microsoft sample or want ready servers inside VS Code.
Good fit when
- A first MCP server in C# is written from a sample and you need a working project with a Dockerfile
- Copilot customization files from awesome-copilot are pulled into the editor through MCP
- An agent must turn Markdown notes into HTML without custom scripts
- An Outlook email is sent from the conversation and the server is studied as an example
- A .NET server is tied to Azure and you want to see how a finished project does it
Not a fit when
- You need a production server with support and updates: these are learning samples
- The project stack is not .NET: an official package for your language is simpler
- You need a ready mail connector with full authorization: the sample shows sending only
Example request
Turn this Markdown summary into HTML through the markdown-to-html server and show the resultMCP
- Transport
- stdio
- Authentication
- not required
Limitations
These are samples and not supported products: Microsoft does not promise their development or stable versions. Run details, environment variables and account setup live in each folder README and not in the root file. The `outlook-email` server needs access to your Outlook account and Azure credentials. Images come from the public `ghcr.io` registry, so Docker is needed to run them. The root README only gives an overview and links to the folders.
How to disable. Remove the server registration in the client or in the VS Code `mcp.json` and stop the Docker container.
FAQ
Which servers are in the repository?
Four: `awesome-copilot` for Copilot customization files, `markdown-to-html` for text conversion, `outlook-email` for sending mail and `todo-list` for a to-do list.
How do I run a sample?
Run the image with a command like `docker run -i --rm ghcr.io/microsoft/mcp-dotnet-samples/markdown-to-html:latest`. The README has install buttons for VS Code and Visual Studio.
What is this repository for?
It shows how to build MCP servers on .NET and integrate them with Azure services: the samples range from a custom implementation to a cloud link.
Are the samples fit for production?
They are learning samples. For production use take them as a base and adapt them: the repository promises no support or stable releases.
Where are the settings for each server?
In the README inside the server folder, for example `awesome-copilot/` or `outlook-email/`. Environment variables and credentials are described there.
Discussion
No questions or reviews yet.
Related
MCP serversMicrosoft's free official MCP server for Microsoft Learn docs: search, page fetch and code samples with no key
The official MCP server registry and the mcp-publisher tool for publishing your own server
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything
Roslyn CodeLens MCP gives an agent a semantic map of a .NET solution: callers, type hierarchies, DI, diagnostics and safe renames
The openmcp CLI and a VS Code extension for debugging MCP servers: tools, prompts and resources, chat with a model, test cases
VS Code extension for finding and installing MCP servers and skills for GitHub Copilot, Claude Code and Codex CLI
README in short
The root README explains what MCP is and gives a table of four samples with install buttons and descriptions. The remaining sections point to MCP materials and a generative AI course on .NET.