Partilhar via

Introdução ao .NET AI e ao Model Context Protocol

O Protocolo de Contexto de Modelo (MCP) é um protocolo aberto concebido para padronizar integrações entre aplicações de IA e ferramentas e fontes de dados externas. Ao usar o MCP, os desenvolvedores podem aprimorar os recursos dos modelos de IA, permitindo que produzam respostas mais precisas, relevantes e sensíveis ao contexto.

Por exemplo, usando o MCP, você pode conectar seu LLM a recursos como:

  • Bancos de dados de documentos ou serviços de armazenamento.
  • APIs da Web que expõem dados corporativos ou lógica.
  • Ferramentas que gerenciam arquivos ou executam tarefas locais no dispositivo de um usuário.

Muitos produtos da Microsoft já suportam MCP, incluindo:

Você pode usar o MCP C# SDK para criar rapidamente suas próprias integrações MCP e alternar entre diferentes modelos de IA sem alterações significativas no código.

Arquitetura cliente-servidor MCP

O MCP usa uma arquitetura cliente-servidor que permite que um aplicativo alimentado por IA (o host) se conecte a vários servidores MCP por meio de clientes MCP:

  • MCP hospeda: ferramentas de IA, editores de código ou outro software que melhoram os seus modelos de IA usando recursos contextuais através do MCP. Por exemplo, o Copilot do GitHub no Visual Studio Code pode atuar como um host MCP e usar clientes e servidores MCP para expandir seus recursos.
  • Clientes MCP: Clientes usados pela aplicação anfitriã para se ligar a servidores MCP e recuperar dados contextuais.
  • Servidores MCP: Serviços que expõem capacidades aos clientes através do MCP. Por exemplo, um servidor MCP pode fornecer uma abstração sobre uma API REST ou fonte de dados local para fornecer dados corporativos ao modelo de IA.

O diagrama a seguir ilustra essa arquitetura:

Um diagrama mostrando o padrão de arquitetura do MCP, incluindo hosts, clientes e servidores.

O cliente e o servidor MCP podem trocar um conjunto de mensagens padrão:

Mensagem Descrição
InitializeRequest Essa solicitação é enviada pelo cliente ao servidor quando ele se conecta pela primeira vez, solicitando que ele inicie a inicialização.
ListToolsRequest Enviado pelo cliente para solicitar uma lista de ferramentas que o servidor possui.
CallToolRequest Usado pelo cliente para invocar uma ferramenta fornecida pelo servidor.
ListResourcesRequest Enviado pelo cliente para solicitar uma lista de recursos de servidor disponíveis.
ReadResourceRequest Enviado pelo cliente ao servidor para ler um URI de recurso específico.
ListPromptsRequest Enviado pelo cliente para solicitar uma lista de prompts disponíveis e modelos de prompt do servidor.
GetPromptRequest Usado pelo cliente para obter um prompt fornecido pelo servidor.
PingRequest Um ping, emitido pelo servidor ou pelo cliente, para verificar se a outra parte ainda está viva.
CreateMessageRequest Um pedido do servidor para obter uma amostra de um LLM através do cliente. O cliente tem total discrição sobre qual modelo selecionar. O cliente também deve informar o usuário antes de iniciar a amostragem, para permitir que ele inspecione a solicitação (humana no loop) e decida se a aprova.
SetLevelRequest Uma solicitação do cliente ao servidor, para habilitar ou ajustar o registro.

Desenvolver com o MCP C# SDK

Como desenvolvedor .NET, você pode usar o MCP criando clientes e servidores MCP para aprimorar seus aplicativos com integrações personalizadas. O MCP reduz a complexidade envolvida na conexão de um modelo de IA a várias ferramentas, serviços e fontes de dados.

O MCP C# SDK oficial está disponível através do NuGet e permite que você crie clientes e servidores MCP para aplicativos e bibliotecas .NET. O SDK é mantido por meio da colaboração entre a Microsoft, a Anthropic e a organização de protocolo aberto MCP.

Para começar, adicione o MCP C# SDK ao seu projeto:

dotnet add package ModelContextProtocol --prerelease

Em vez de criar conectores exclusivos para cada ponto de integração, muitas vezes você pode aproveitar ou fazer referência a integrações pré-criadas de vários provedores, como GitHub e Docker:

Integração com Microsoft.Extensions.AI

O MCP C# SDK depende das bibliotecas Microsoft.Extensions.AI para lidar com várias interações e tarefas de IA. Essas bibliotecas de extensão fornecem tipos e abstrações principais para trabalhar com serviços de IA, para que os desenvolvedores possam se concentrar na codificação em relação a recursos conceituais de IA, em vez de plataformas específicas ou implementações de provedores.

Exiba as dependências do SDK MCP C# na página do pacote NuGet.

Mais recursos de desenvolvimento do .NET MCP

Várias ferramentas, serviços e recursos de aprendizagem estão disponíveis nos ecossistemas .NET e Azure para ajudá-lo a criar clientes e servidores MCP ou integrar com servidores MCP existentes.

Comece com as seguintes ferramentas de desenvolvimento:

  • O Agent Framework suporta integração com servidores MCP, permitindo que os seus agentes acedam a ferramentas e serviços externos. O Agent Framework funciona com o SDK oficial MCP C# para permitir que os agentes se conectem a servidores MCP, recuperem as ferramentas disponíveis e as utilizem através de chamadas de funções para estender as capacidades dos agentes com fontes de dados e serviços externos.
  • Os servidores MCP remotos do Azure Functions combinam padrões MCP com a arquitetura flexível do Azure Functions. Visite o repositório de exemplo de funções MCP remotas para obter exemplos de código.
  • O Servidor MCP do Azure implementa a especificação MCP para conectar diretamente agentes de IA com os principais serviços do Azure, como o Armazenamento do Azure, o Cosmos DB e muito mais.

Consulte também

  • Last updated on