C# MCP SDK

Visão Geral

O C# MCP SDK (repositório: modelcontextprotocol/csharp-sdk) é o SDK .NET oficial para o Model Context Protocol, desenvolvido em colaboração com a Microsoft. Ele permite que desenvolvedores .NET implementem servidores e clientes MCP com APIs idiomáticas em C#, tornando simples conectar agentes de IA a aplicações .NET, fontes de dados corporativas, APIs internas e fluxos de trabalho personalizados.

Lançado na versão estável v1.0 em março de 2026 com suporte completo à especificação MCP de 2025.11.25, o SDK é Tier 1 no ecossistema MCP oficial e é a forma recomendada para equipes C#/.NET participarem do crescente cenário MCP.

Principais Características

• Suporte Completo à Especificação MCP: Implementa o protocolo mais recente (2025-11-25) incluindo Tools, Resources, Prompts, Elicitation, Sampling e Tasks experimentais.
• Três Pacotes NuGet:
  • ModelContextProtocol.Core — Dependências mínimas para clientes e servidores de baixo nível.
  • ModelContextProtocol — Funcionalidade completa para a maioria dos casos de uso.
  • ModelContextProtocol.AspNetCore — Integração perfeita com ASP.NET Core para transporte HTTP/SSE.
• Definição Fácil de Tools: Decore métodos com atributos ou use APIs fluentes para expor funções C# como MCP Tools com geração automática de JSON Schema.
• Autorização Integrada: Suporte de primeira classe para OAuth 2.1, OpenID Connect discovery, PKCE e consentimento incremental de escopo.
• Múltiplos Transportes: stdio, HTTP, SSE e Streamable HTTP.
• Integração Microsoft.Extensions.AI: Interoperabilidade suave com Semantic Kernel e outras bibliotecas de IA .NET.
• Pronto para Produção: Observabilidade, logging, injeção de dependência, acesso a HttpContext e opções de compatibilidade AOT.
• Excelente Documentação: Documentação abrangente da API em csharp.sdk.modelcontextprotocol.io.

Como Funciona

Construindo um Servidor MCP (Exemplo Mínimo)

using ModelContextProtocol;

var builder = WebApplication.CreateBuilder(args);

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

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

Defina tools de forma simples:

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

Agentes de IA (Claude Desktop, Cursor, etc.) podem então descobrir e chamar essas tools automaticamente.

Casos de Uso

• Integração de Dados Corporativos: Exponha bancos de dados internos, sistemas CRM ou APIs de negócio para agentes de IA de forma segura.
• Ferramentas .NET para Agentes: Construa servidores MCP que permitam à IA controlar dotnet CLI, analisadores Roslyn, pacotes NuGet ou recursos do Azure.
• Fluxos de Trabalho de IA Personalizados: Conecte serviços .NET legados a aplicações modernas baseadas em agentes.
• Aplicações Híbridas de IA: Combine MCP com Semantic Kernel ou Microsoft.Extensions.AI para experiências ricas com agentes.
• Ferramentas Internas de Desenvolvimento: Crie ferramentas específicas da organização para geração de código, implantação ou monitoramento.

Começando

1. Instale o pacote principal:

   dotnet add package ModelContextProtocol
   

2. Siga os guias rápidos oficiais no repositório GitHub ou na Documentação do SDK.

3. Explore exemplos ricos em microsoft/mcp-dotnet-samples.

O SDK funciona com aplicativos de console, ASP.NET Core, Azure Functions e mais. Suporte completo para implementações de servidor e cliente.

Benefícios

O SDK MCP para C# traz o poder do Model Context Protocol para o ecossistema .NET com padrões familiares, tipagem forte, injeção de dependência e segurança de nível empresarial. Ele reduz a barreira para equipes .NET criarem servidores MCP de produção mantendo compatibilidade total com o ecossistema MCP mais amplo (Claude, Cursor, Gemini CLI, etc.).

Como um SDK oficial Tier 1 mantido com a Microsoft, ele recebe atualizações oportunas alinhadas com a especificação MCP em evolução e é amplamente usado tanto para ferramentas internas quanto para integrações públicas de IA.

Links Oficiais:

• GitHub: https://github.com/modelcontextprotocol/csharp-sdk
• Documentação: https://csharp.sdk.modelcontextprotocol.io/
• Anúncio no Blog .NET: https://devblogs.microsoft.com/dotnet/release-v10-of-the-official-mcp-csharp-sdk/