Skip to content

Latest commit

 

History

History
283 lines (180 loc) · 14.4 KB

README.md

File metadata and controls

283 lines (180 loc) · 14.4 KB

Implementação Prática

Como Construir, Testar e Implementar Aplicações MCP com Ferramentas e Fluxos de Trabalho Reais

(Clique na imagem acima para assistir ao vídeo desta lição)

A implementação prática é onde o poder do Model Context Protocol (MCP) se torna palpável. Embora compreender a teoria e a arquitetura por trás do MCP seja importante, o verdadeiro valor surge quando aplicamos esses conceitos para construir, testar e implementar soluções que resolvem problemas do mundo real. Este capítulo faz a ponte entre o conhecimento conceitual e o desenvolvimento prático, guiando-o no processo de dar vida a aplicações baseadas em MCP.

Quer esteja a desenvolver assistentes inteligentes, a integrar IA em fluxos de trabalho empresariais ou a criar ferramentas personalizadas para processamento de dados, o MCP oferece uma base flexível. O seu design independente de linguagem e os SDKs oficiais para linguagens de programação populares tornam-no acessível a uma ampla gama de programadores. Ao utilizar esses SDKs, pode rapidamente criar protótipos, iterar e escalar as suas soluções em diferentes plataformas e ambientes.

Nas seções seguintes, encontrará exemplos práticos, código de exemplo e estratégias de implementação que demonstram como aplicar o MCP em C#, Java com Spring, TypeScript, JavaScript e Python. Também aprenderá a depurar e testar servidores MCP, gerir APIs e implementar soluções na nuvem usando Azure. Esses recursos práticos foram projetados para acelerar o seu aprendizado e ajudá-lo a construir aplicações MCP robustas e prontas para produção com confiança.

Visão Geral

Esta lição foca nos aspetos práticos da implementação do MCP em várias linguagens de programação. Exploraremos como usar os SDKs do MCP em C#, Java com Spring, TypeScript, JavaScript e Python para construir aplicações robustas, depurar e testar servidores MCP, e criar recursos, prompts e ferramentas reutilizáveis.

Objetivos de Aprendizagem

Ao final desta lição, será capaz de:

  • Implementar soluções MCP usando SDKs oficiais em várias linguagens de programação
  • Depurar e testar servidores MCP de forma sistemática
  • Criar e utilizar funcionalidades de servidor (Recursos, Prompts e Ferramentas)
  • Projetar fluxos de trabalho MCP eficazes para tarefas complexas
  • Otimizar implementações MCP para desempenho e fiabilidade

Recursos Oficiais de SDK

O Model Context Protocol oferece SDKs oficiais para várias linguagens:

Trabalhando com SDKs do MCP

Esta seção fornece exemplos práticos de implementação do MCP em várias linguagens de programação. Pode encontrar código de exemplo no diretório samples, organizado por linguagem.

Exemplos Disponíveis

O repositório inclui implementações de exemplo nas seguintes linguagens:

Cada exemplo demonstra conceitos-chave do MCP e padrões de implementação para a linguagem e ecossistema específicos.

Funcionalidades Principais do Servidor

Os servidores MCP podem implementar qualquer combinação destas funcionalidades:

Recursos

Recursos fornecem contexto e dados para o utilizador ou modelo de IA utilizar:

  • Repositórios de documentos
  • Bases de conhecimento
  • Fontes de dados estruturados
  • Sistemas de ficheiros

Prompts

Prompts são mensagens e fluxos de trabalho modelados para utilizadores:

  • Modelos de conversação pré-definidos
  • Padrões de interação guiada
  • Estruturas de diálogo especializadas

Ferramentas

Ferramentas são funções que o modelo de IA pode executar:

  • Utilitários de processamento de dados
  • Integrações com APIs externas
  • Capacidades computacionais
  • Funcionalidade de pesquisa

Implementações de Exemplo: Implementação em C#

O repositório oficial do SDK C# contém várias implementações de exemplo que demonstram diferentes aspetos do MCP:

  • Cliente MCP Básico: Exemplo simples mostrando como criar um cliente MCP e chamar ferramentas
  • Servidor MCP Básico: Implementação mínima de servidor com registo básico de ferramentas
  • Servidor MCP Avançado: Servidor completo com registo de ferramentas, autenticação e tratamento de erros
  • Integração com ASP.NET: Exemplos demonstrando integração com ASP.NET Core
  • Padrões de Implementação de Ferramentas: Vários padrões para implementar ferramentas com diferentes níveis de complexidade

O SDK C# do MCP está em pré-visualização e as APIs podem mudar. Continuaremos a atualizar este blog à medida que o SDK evolui.

Funcionalidades Principais

Para exemplos completos de implementação em C#, visite o repositório oficial de exemplos do SDK C#

Implementação de Exemplo: Implementação em Java com Spring

O SDK Java com Spring oferece opções robustas de implementação MCP com funcionalidades de nível empresarial.

Funcionalidades Principais

  • Integração com Spring Framework
  • Forte segurança de tipos
  • Suporte a programação reativa
  • Tratamento abrangente de erros

Para um exemplo completo de implementação em Java com Spring, veja exemplo Java com Spring no diretório de exemplos.

Implementação de Exemplo: Implementação em JavaScript

O SDK JavaScript fornece uma abordagem leve e flexível para implementação do MCP.

Funcionalidades Principais

  • Suporte para Node.js e navegador
  • API baseada em Promises
  • Integração fácil com Express e outros frameworks
  • Suporte a WebSocket para streaming

Para um exemplo completo de implementação em JavaScript, veja exemplo JavaScript no diretório de exemplos.

Implementação de Exemplo: Implementação em Python

O SDK Python oferece uma abordagem Pythonic para implementação do MCP com excelentes integrações com frameworks de ML.

Funcionalidades Principais

  • Suporte a async/await com asyncio
  • Integração com FastAPI
  • Registo simples de ferramentas
  • Integração nativa com bibliotecas populares de ML

Para um exemplo completo de implementação em Python, veja exemplo Python no diretório de exemplos.

Gestão de API

O Azure API Management é uma excelente solução para proteger servidores MCP. A ideia é colocar uma instância do Azure API Management à frente do seu servidor MCP e deixá-lo lidar com funcionalidades que provavelmente desejará, como:

  • Limitação de taxa
  • Gestão de tokens
  • Monitorização
  • Balanceamento de carga
  • Segurança

Exemplo Azure

Aqui está um exemplo Azure que faz exatamente isso, ou seja, criar um servidor MCP e protegê-lo com Azure API Management.

Veja como o fluxo de autorização acontece na imagem abaixo:

APIM-MCP

Na imagem anterior, ocorre o seguinte:

  • Autenticação/Autorização ocorre usando Microsoft Entra.
  • O Azure API Management atua como um gateway e usa políticas para direcionar e gerir o tráfego.
  • O Azure Monitor regista todas as solicitações para análise posterior.

Fluxo de Autorização

Vamos analisar o fluxo de autorização em mais detalhe:

Diagrama de Sequência

Especificação de Autorização MCP

Saiba mais sobre a especificação de autorização MCP

Implementar Servidor MCP Remoto no Azure

Vamos ver se conseguimos implementar o exemplo mencionado anteriormente:

  1. Clone o repositório

    git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git
cd remote-mcp-apim-functions-python

  2. Registe o fornecedor de recursos Microsoft.App.

    • Se estiver a usar Azure CLI, execute az provider register --namespace Microsoft.App --wait.
    • Se estiver a usar Azure PowerShell, execute Register-AzResourceProvider -ProviderNamespace Microsoft.App. Depois execute (Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState após algum tempo para verificar se o registo está concluído.

  3. Execute este comando azd para provisionar o serviço de gestão de API, aplicação de funções (com código) e todos os outros recursos necessários do Azure

    azd up

    Este comando deve implementar todos os recursos na nuvem no Azure.

Testar o seu servidor com MCP Inspector

  1. Numa nova janela de terminal, instale e execute o MCP Inspector

    npx @modelcontextprotocol/inspector

    Deve ver uma interface semelhante a:

    Conectar ao Node inspector

  2. CTRL clique para carregar a aplicação web MCP Inspector a partir do URL exibido pela aplicação (ex.: http://127.0.0.1:6274/#resources)

  3. Defina o tipo de transporte como SSE

  4. Defina o URL para o seu endpoint SSE de gestão de API em execução exibido após azd up e Conecte-se:

    https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse

  5. Listar Ferramentas. Clique numa ferramenta e Executar Ferramenta.

Se todos os passos funcionaram, agora deve estar conectado ao servidor MCP e conseguiu chamar uma ferramenta.

Servidores MCP para Azure

Remote-mcp-functions: Este conjunto de repositórios é um modelo de início rápido para construir e implementar servidores MCP (Model Context Protocol) remotos personalizados usando Azure Functions com Python, C# .NET ou Node/TypeScript.

Os exemplos fornecem uma solução completa que permite aos programadores:

  • Construir e executar localmente: Desenvolver e depurar um servidor MCP numa máquina local
  • Implementar no Azure: Implementar facilmente na nuvem com um simples comando azd up
  • Conectar a partir de clientes: Conectar ao servidor MCP a partir de vários clientes, incluindo o modo agente do Copilot no VS Code e a ferramenta MCP Inspector

Funcionalidades Principais

  • Segurança por design: O servidor MCP é protegido usando chaves e HTTPS
  • Opções de autenticação: Suporta OAuth usando autenticação integrada e/ou gestão de API
  • Isolamento de rede: Permite isolamento de rede usando Redes Virtuais do Azure (VNET)
  • Arquitetura sem servidor: Utiliza Azure Functions para execução escalável e orientada por eventos
  • Desenvolvimento local: Suporte abrangente para desenvolvimento e depuração local
  • Implementação simples: Processo de implementação simplificado para o Azure

O repositório inclui todos os ficheiros de configuração necessários, código-fonte e definições de infraestrutura para começar rapidamente com uma implementação de servidor MCP pronta para produção.

Conclusões Principais

  • Os SDKs do MCP fornecem ferramentas específicas para implementar soluções MCP robustas
  • O processo de depuração e teste é crítico para aplicações MCP fiáveis
  • Modelos de prompts reutilizáveis permitem interações consistentes com IA
  • Fluxos de trabalho bem projetados podem orquestrar tarefas complexas usando várias ferramentas
  • Implementar soluções MCP requer consideração de segurança, desempenho e tratamento de erros

Exercício

Projete um fluxo de trabalho MCP prático que resolva um problema real no seu domínio:

  1. Identifique 3-4 ferramentas que seriam úteis para resolver este problema
  2. Crie um diagrama de fluxo mostrando como essas ferramentas interagem
  3. Implemente uma versão básica de uma das ferramentas usando a sua linguagem preferida
  4. Crie um modelo de prompt que ajude o modelo a usar eficazmente a sua ferramenta

Recursos Adicionais

Próximo: Tópicos Avançados

Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autoritária. Para informações críticas, recomenda-se a tradução profissional realizada por humanos. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.