Provides .NET sample MCP servers that convert markdown, send Outlook email, manage to-dos, and fetch Copilot files.
Also known as microsoft/mcp-dotnet-samples, mcp-dotnet-samples
- Stars
- 202
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.2026111303
- Last commit
- Nov 13, 2026
- License
- MIT
What is NET MCP Samples MCP?
NET MCP Samples is an MCP server. Provides .NET sample MCP servers that convert markdown, send Outlook email, manage to-dos, and fetch Copilot files.
Summary generated from the project's README
How to install NET MCP Samples MCP
Formats verified 10 Nov 2026Install NET MCP Samples MCP in Claude Code
$ claude mcp add mcp-dotnet-samples -- docker run -i --rm ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:1.0.2026111303Install NET MCP Samples MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-dotnet-samples": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:1.0.2026111303"
]
}
}
}Install NET MCP Samples MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-dotnet-samples": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:1.0.2026111303"
]
}
}
}Install NET MCP Samples MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-dotnet-samples": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:1.0.2026111303"
]
}
}
}Install NET MCP Samples MCP in Codex
~/.codex/config.toml
[mcp_servers.mcp-dotnet-samples] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:1.0.2026111303"]
Install NET MCP Samples MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"mcp-dotnet-samples": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:1.0.2026111303"
]
}
}
}README
View on GitHubModel Context Protocol .NET Samples
🚀 Introduction
Welcome to the Model Context Protocol (MCP) .NET Samples repository! This collection of samples demonstrates how to leverage the Model Context Protocol in .NET applications.
MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). Think of MCP like a USB-C port for AI applications - it provides a standardized way to connect AI models to different data sources and tools.
With MCP, you can:
- Utilize pre-built integrations that your LLM can directly plug into
- Flexibly switch between LLM providers and vendors
- Follow best practices for securing your data within your infrastructure
- Build agents and complex workflows on top of LLMs
This repository contains .NET samples ranging from building your own MCP implementation to integrating with Azure services.
📋 Sample Projects
| Sample Name | Install | Description |
|---|---|---|
| Awesome Copilot |    |
MCP server that retrieves GitHub Copilot customization files from awesome-copilot. |
| Markdown to HTML | |
MCP server that converts markdown text to HTML. |
| Outlook Email | |
MCP server that sends emails through Outlook. |
| To-do List | |
MCP server that manages to-do list items. |
🛠️ Getting Started
Details on how to set up and run the samples will be provided in each sample's directory.
📚 Learning Resources
🚶♀️ Next Steps
- Learn more about GenAI with .NET with a free course!
- Join the Azure AI Community Discord to keep the conversation going
Contributing
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Trademarks
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.
NET MCP Samples MCP questions
How do I add NET MCP Samples MCP to Claude Code?
Run claude mcp add mcp-dotnet-samples -- docker run -i --rm ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:1.0.2026111303 in your terminal. Add --scope user to make it available in every project.
How do I add NET MCP Samples MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What is the markdown-to-html .NET MCP sample?
It is a sample MCP server that converts markdown text to HTML, installable via Docker.
Can the .NET MCP samples send email through Outlook?
Yes, the Outlook Email sample is an MCP server that sends emails through Outlook.
Is there a to-do list MCP sample in .NET?
Yes, the To-do List sample is an MCP server that manages to-do list items.