C# MCP SDK

Resumen

El C# MCP SDK (repositorio: modelcontextprotocol/csharp-sdk) es el SDK oficial .NET para el Model Context Protocol, desarrollado en colaboración con Microsoft. Permite a los desarrolladores .NET implementar servidores y clientes MCP con APIs idiomáticas en C#, facilitando la conexión de agentes de IA con aplicaciones .NET, fuentes de datos empresariales, APIs internas y flujos de trabajo personalizados.

Lanzado a su versión estable v1.0 en marzo de 2026 con soporte completo para la especificación MCP 2025-11-25, el SDK es de Nivel 1 en el ecosistema oficial MCP y es la forma recomendada para que los equipos de C#/.NET participen en el creciente panorama MCP.

Características Clave

• Soporte Completo de la Especificación MCP: Implementa el último protocolo 2025-11-25, incluyendo Herramientas, Recursos, Indicaciones (Prompts), Elaboración (Elicitation), Muestreo (Sampling) y Tareas experimentales.
• Tres Paquetes NuGet:
  • ModelContextProtocol.Core — Dependencias mínimas para clientes y servidores de bajo nivel.
  • ModelContextProtocol — Con todas las funciones para la mayoría de los casos de uso.
  • ModelContextProtocol.AspNetCore — Integración perfecta con ASP.NET Core para transporte HTTP/SSE.
• Definición Sencilla de Herramientas: Decora métodos con atributos o usa APIs fluidas para exponer funciones de C# como Herramientas MCP con generación automática de esquemas JSON.
• Autorización Integrada: Soporte de primera clase para OAuth 2.1, descubrimiento OpenID Connect, PKCE y consentimiento incremental de alcances.
• Múltiples Transportes: stdio, HTTP, SSE y HTTP transmitible (Streamable HTTP).
• Integración con Microsoft.Extensions.AI: Interoperabilidad fluida con Semantic Kernel y otras bibliotecas de IA .NET.
• Listo para Producción: Observabilidad, registro, inyección de dependencias, acceso a HttpContext y opciones de compatibilidad AOT.
• Excelente Documentación: Documentación API completa en csharp.sdk.modelcontextprotocol.io.

Cómo Funciona

Construyendo un Servidor MCP (Ejemplo Mínimo)

using ModelContextProtocol;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithTools<MyCustomTools>();

var app = builder.Build();
app.MapMcp();
app.Run();

Define herramientas de manera sencilla:

public class MyCustomTools
{
    [McpTool]
    public string GetWeather(string city) 
        => $"Sunny in {city}";
}

Los agentes de IA (Claude Desktop, Cursor, etc.) pueden entonces descubrir y llamar a estas herramientas automáticamente.

Casos de Uso

• Integración de Datos Empresariales: Expone bases de datos internas, sistemas CRM o APIs empresariales a agentes de IA de forma segura.
• Herramientas .NET para Agentes: Construye servidores MCP que permiten a la IA controlar la CLI de dotnet, analizadores Roslyn, paquetes NuGet o recursos de Azure.
• Flujos de Trabajo de IA Personalizados: Conecta servicios .NET heredados con aplicaciones agentes modernas.
• Aplicaciones Híbridas de IA: Combina MCP con Semantic Kernel o Microsoft.Extensions.AI para experiencias de agentes enriquecidas.
• Herramientas Internas de Desarrollo: Crea herramientas específicas de la organización para generación de código, despliegue o monitorización.

Primeros pasos

1. Instala el paquete principal:

   dotnet add package ModelContextProtocol
   

2. Sigue las guías rápidas oficiales en el repositorio de GitHub o en la documentación del SDK.

3. Explora ejemplos detallados en microsoft/mcp-dotnet-samples.

El SDK funciona con aplicaciones de consola, ASP.NET Core, Azure Functions y más. Compatibilidad completa para implementaciones tanto de servidor como de cliente.

Beneficios

El C# MCP SDK lleva el poder del Model Context Protocol al ecosistema .NET con patrones familiares, tipado fuerte, inyección de dependencias y seguridad de nivel empresarial. Reduce la barrera para que los equipos .NET construyan servidores MCP para producción mientras mantienen la compatibilidad total con el ecosistema MCP más amplio (Claude, Cursor, Gemini CLI, etc.).

Como un SDK oficial de Nivel 1 mantenido con Microsoft, recibe actualizaciones oportunas alineadas con la especificación MCP en evolución y es ampliamente utilizado tanto para herramientas internas como para integraciones públicas de IA.

Enlaces oficiales:

• GitHub: https://github.com/modelcontextprotocol/csharp-sdk
• Documentación: https://csharp.sdk.modelcontextprotocol.io/
• Anuncio en el blog de .NET: https://devblogs.microsoft.com/dotnet/release-v10-of-the-official-mcp-csharp-sdk/