Improved MCP server resources documentation by enhancing descriptions and organizing links into tables

Author: leslierichardson95

docs/ai/resources/mcp-servers.md

@@ -1,6 +1,6 @@
 ---
 title: MCP server learning resources
-description: This article provides a list of resources .NET developers who are building MCP servers.
+description: This article provides a list of resources for .NET developers who are building MCP servers.
 ms.date: 09/04/2025
 ms.topic: reference
 ---
@@ -9,29 +9,53 @@ ms.topic: reference
 
 This article contains an organized list of the best learning resources for .NET developers who are building Model Context Protocol (MCP) servers. Resources include samples, documentation, videos, and workshops.
 
-## Get started resources
+## Getting Started
 
-- [Get started with MCP](https://modelcontextprotocol.io/docs/getting-started/intro)
-- [MCP for beginners](https://github.com/microsoft/mcp-for-beginners)
-- [Create a minimal MCP server using C# and publish to NuGet](../quickstarts/build-mcp-server.md)
+|Link|Description|
+|---|---|
+|[Anthropic - Getting Started with MCP](https://modelcontextprotocol.io/docs/getting-started/intro)|Anthropic's official guide to the Model Context Protocol (MCP) and overview on how to get started writing or using an MCP server.|
+|[Create a minimal MCP server using C# and publish to NuGet](../quickstarts/build-mcp-server.md)|A quick guide to writing MCP server in VS Code and publishing it to NuGet.|
+|[MCP for Beginners GitHub Repo ](https://github.com/microsoft/mcp-for-beginners)|A Microsoft-official Github repository with a full, hands-on curriculum for developing MCP servers in .NET, Java, TypeScript, JavaScript, Rust and Python.|
+|[Build Agents using MCP on Azure](https://learn.microsoft.com/en-us/azure/developer/ai/build-openai-mcp-server-dotnet?tabs=github-codespaces)| A walkthrough on how to connect an MCP client using Azure OpenAI and MCP server to Azure Container Apps.
 
-## Concepts
+## Libraries
 
-- [Build Agents using MCP on Azure](/azure/developer/ai/intro-agents-mcp)
+|Link|Description|
+|---|---|
+|[MCP C# SDK](https://github.com/modelcontextprotocol/csharp-sdk)|Microsoft and Anthropic's official C# SDK for MCP servers and clients.|
 
-## Workshops
+## Samples
 
-- [MCP workshop](https://github.com/Azure-Samples/mcp-workshop-dotnet)
+|Link|Description|
+|---|---|
+|[MCP Workshop GitHub repo](https://github.com/Azure-Samples/mcp-workshop-dotnet)|A sample MCP server and client with corresponding, step-by-step walkthroughs on how to implement them and how MCP works.|
 
-## Reference material
+## Documentation 
 
-- [MCP C# SDK docs](https://modelcontextprotocol.github.io/csharp-sdk/index.html)
-- [MCP servers for VS Code](https://code.visualstudio.com/mcp)
-- [MCP server reference](https://github.com/modelcontextprotocol/servers)
-- [MCP inspector tool](https://github.com/modelcontextprotocol/inspector)
+|Link|Description|
+|---|---|
+|[MCP C# SDK Documentation](https://modelcontextprotocol.github.io/csharp-sdk/index.html)|Anthropic's official guide to the Model Context Protocol (MCP) and overview on how to get started writing or using an MCP server.|
+|[VS Code MCP Developer Guide](https://code.visualstudio.com/api/extension-guides/ai/mcp)| Official documentation for building, debugging, and registering an MCP server in VS Code.|
+
+## Additional Resources
+
+|Link|Description|
+|---|---|
+|[MCP Inspector Tool](https://github.com/modelcontextprotocol/inspector)|The Anthropic-official GitHub repo for the MCP Inspector tool, a visual testing and debugging tool for MCP servers.|
+|[MCP servers for VS Code](https://code.visualstudio.com/mcp)|A hub for quickly installing 1st- and 3rd-party MCP servers in VS Code.|
+|[3rd-Party MCP servers](https://github.com/modelcontextprotocol/servers?tab=readme-ov-file#-third-party-servers)|A GitHub repo containing a comprehensive list of publicly-available MCP servers.|
 
 ## Videos
 
-- [Beginner's guide to building an MCP server with C# and .NET](https://youtu.be/MKD-sCZWpZQ?si=q7MPtBfCuAJXNwJN)
-- [Build MCP servers with ASP.NET Core](https://www.youtube.com/live/x_6iUhdHnhc?si=J8QQuirYWk0JXC_V)
-- [MCP Dev Days (Microsoft Reactor)](https://developer.microsoft.com/reactor/series/S-1563/)
+|Link|Description|
+|---|---|
+|[MCP Dev Days (Microsoft Reactor)](https://developer.microsoft.com/reactor/series/S-1563/)|A 2-day virtual event and video series showing how to use and write MCP servers.|
+|[ASP.NET Community Standup - Build MCP servers with ASP.NET Core](https://www.youtube.com/live/x_6iUhdHnhc?si=J8QQuirYWk0JXC_V)|A roundtable discussion and demo on building an MCP server with ASP.NET Core and the MCP C# SDK.|
+|[MCP for Beginners GitHub Repo ](https://github.com/microsoft/mcp-for-beginners)|A Microsoft-official Github repository with a full, hands-on curriculum for developing MCP servers in .NET, Java, TypeScript, JavaScript, Rust and Python.|
+
+## Communities
+
+|Link|Description|
+|---|---|
+|[Anthropic MCP Discussions](https://github.com/orgs/modelcontextprotocol/discussions)|An open forum for discussing MCP in Anthropic's official MCP GitHub repo.|
+|[Azure AI Foundry Discord](https://discord.com/invite/ByRwuEEgH4)|A Discord discussion space for developers looking to build with Microsoft AI tooling.|